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Introduction 



Purpose of this Publication 

This publication is a reference text for personnel writ- 
ing programs in the Autocoder language for use with 
the ibm 1410/7010 Operating System. 



Purpose of the Language and Processor 

The 1410/7010 Autocoder is one of three programming 
systems provided by the Operating System. ( The other 
two are Fortran and cobol. ) Autocoder consists of a 
symbolic coding language and an assembly program 
called a processor. 

Utilizing the required elements provided by the 
Autocoder language, a program can be created by cod- 
ing the steps necessary for the solution of the problem, 
and presenting them in the form of statements. The 
Autocoder processor translates these statements into 
the computer's internal language, and assembles them 
in the form of a relocatable subprogram. The resulting 
relocatable subprogram can then be processed by the 
Linkage Loader and used whenever necessary. 

The Autocoder Language: Elements of Source 
Statements 

The user's source program is written by using mnemonic 
symbols to represent the principal elements of the 
source statements. These elements are ( 1 ) the name of 
the statement (a label), (2) the operation to be per- 
formed by the statement ( an operation code ) , and ( 3 ) 
the program elements or parameters on which the 
operation is to be based and/or performed (the 
operand). 

Macro statements in a user's source program cause 
additional symbolic source statements to be generated 
and inserted into the program. The generated source 
statements will be tailored according to the logic of the 
macro routine the programmer has placed in the Macro 
Library and the parameters in the source macro- 
instructions. 

The Autocoder Processor: Used with the Operating 
System 

The 1410/7010 Autocoder processor is designed to op- 
erate in conjunction with the Operating System. The 
object programs produced are assembled and run ac- 
cording to the conventions of the Operating System. 



THE ASSEMBLY PROCESS 

The assembly process produces an assembly listing and 
an object program in card-image form called, in this 
publication, an object deck. The object deck is in re- 
locatable format, ready for processing by the Linkage 
Loader. 

The programs assembled by the 1410/7010 Auto- 
coder processor must be designed to run exclusively 
within the framework of the Operating System. The 
Resident Monitor, including the Resident iocs, provides 
a great deal of power by simplifying the task of pro- 
gramming. A minimum of programming need be 
concerned with operating control and input/output 
operations, since macro-instructions are available for 
these functions. 

THE OBJECT PROGRAM 

The following points should be noted concerning the 
object program as it is discussed in this publication, 
and executed within the framework of the Operating 
System: 

1. The object program will be referred to as a sub- 
program. (A subprogram is the basic program unit with 
which the Linkage Loader performs its processing.) 
This subprogram can be a self-contained program, or 
it can be a subroutine to be executed in conjunction 
with other subprograms, forming a multiphase pro- 
gram. 

2. Subprograms to be combined during one run of 
the Linkage Loader can be assembled individually at 
different times or during a single assembly run. 



Prerequisites 

It is assumed that the user has completed a basic course 
in programming for the ibm 1410 or ibm 7010 Data 
Processing System, and is familiar with information 
contained in the following publications: 
IBM 1410 Principles of Operation, Form A22-0526, or 
IBM 7010 Principles of Operation, Form A22-6726, 

and 
IBM 1410/7010 Operating System; Basic Concepts, 

Form C28-0318 
IBM 1410/7010 Operating System; System Monitor, 

Form C28-0319 
The Autocoder user must know certain Operating 
System conventions and requirements in order to write, 
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assemble, and execute his programs properly. The 
pertinent information is contained in the following 
publications : 

IBM 1410/7010 Operating System; System Monitor, 
Form C28-0319. 

IBM 1410/7010 Operating System; Basic Input/Out- 
put Control System, Form C28-0322. 

Operating instructions for the System are contained 
in the publication, IBM 1410/7010 Operating System; 
Operators Guide, Form C28-0351. 

This manual will indicate specific cross references 
to the above-listed publications at the appropriate 



places. The user will find that the many advantages 
and conveniences of the Operating System can be 
implemented through the use of Autocoder. 

Minimum Machine Requirements 

The minimum machine requirements for assembling 
source programs written in the Autocoder language 
are specified in the publication, IBM 1410/7010 Oper- 
ating System; System Generation, Form C28-0352. 

Machine requirements for the execution of the ob- 
ject program depend upon the combined requisites 
of the System Monitor and the user's program. 



Basic Concepts and Functions 



This section describes Autocoder statements and the 
principal elements used in their construction; program- 
ming concepts under the Operating System; the assem- 
bly listing produced by the processor; and the coding 
sheet upon which source statements are coded. Suc- 
ceeding sections discuss the various types of permis- 
sible operands, Autocoder operation codes, and the 
Macro System. 



Autocoder Statements 

The source program, which is translated by the Auto- 
coder processor into an object program, is composed 
of five types of Autocoder statements: 

Imperative ( symbolic machine instructions ) 

Declarative 

Linkage Loader 

Control 

Assembly Control Statements 
Subprogram Control Statements 
Macro 
Imperative Statements are translated into the ma- 
chine instructions that appear in the object program. 
Declarative Statements are translated into data 
areas, data constants, and address constants used by 
the object program. They are also used to define 
symbols (or labels) in the assembly process. 

Linkage Loader Statements enable the Linkage 
Loader to properly convert the relocatable subpro- 
grams assembled by the Autocoder processor into ab- 
solute format (ready for execution). 

Control Statements are directions to the Autocoder 
processor, which control the performance of specified 
operations at assembly time. 

Macro-instructions enable the programmer to ex- 
tract, from a library of macro routines, instruction se- 
quences tailored (by means of parameters written in 
macro-instructions ) to meet programmer specifications. 
These instruction sequences are inserted automatically 
into the object program. (See the section entitled 
"The Macro System.") 



Principal Elements of Autocoder Statements 

The principal elements of an Autocoder statement are: 
a label, an operation code, and an operand. 



Label 

A label is a name assigned by the programmer to an 
element in a program (e.g., a data area, constant, or 
instruction ) . This enables operands of Autocoder state- 
ments, referencing labeled elements, to have symbolic 
form. The terms label and symbol will be used syn- 
onymously throughout this publication. 

A label can contain from one to ten alphameric char- 
acters, which are left-justified in the label field (card 
columns 6-15). The first character must be alphabetic. 
A special case in which labels are not left-justified is 
explained in the sections concerning ds, dc and dcw 
statements. 

Special characters must not be used in the label 
field. (An exception is permitted in the defin state- 
ment. See "defin — Definition," under "Linkage Loader 
Operation Codes.") 

Operation Code 

The operation code field (card columns 16-20) con- 
tains a one-to-five-character mnemonic that specifies 
the nature of the Autocoder statement and indicates 
to the processor the function to be performed during 
the assembly process. A table of operation codes is 
supplied in the section, "Autocoder Operation Codes." 

Operation codes in machine language must never be 
used. (The Compare, Add, and Subtract imperative 
operations are exceptions, in that the machine-lan- 
guage equivalent for each is identical to the corre- 
sponding mnemonic.) 

Blank operation codes are permitted in conjunction 
with the following mnemonics: dc, dcw, da, and dav. 
These mnemonics are discussed in the subsection en- 
titled "Declarative Operation Codes." 

The mnemonic operation codes are listed in Appen- 
dix D. In studying this list, the programmer will note 
that groups of mnemonic operation codes ( for example, 
the group of mnemonics for the scan instructions ) are 
represented in machine language by a one-character 
operation code and an operation modifier ( d-character ) 
which defines the precise function the operation is 
to perform. This is true even though the mnemonic 
may be as many as five positions long. 

Operand 

The operand field begins in card column 21. The form 
and content of the various permissible operand ele- 
ments vary according to the operation to be performed. 
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However, the basic elements in the operand field are 
the A- and B-addresses, and the d-character (when 
required). An A-address, a B-address, and a d-charac- 
ter are separated from each other by single commas 
(Figure 1). 

The formats of these and the other permissible op- 
erand elements are discussed in the section "Types 
of Operand Entries." The use of these elements in 
association with specific operation codes is discussed 
in the sections "Autocoder Operation Codes," and 
"The Macro System." 



Relocation 

All object programs produced by the compilers within 
the Operating System are in relocatable format. The 
aspects of relocation with which the Autocoder user 
must be familiar are noted here. The reader interested 
in a detailed discussion of this subject and the relo- 
cation indicators that can appear in the assembly list- 
ing should refer to the publication, IBM 1410/7010 
Operating System; System Monitor, Form C28-0319. 
Relocation is achieved in three steps: 

1. The programmer codes subprograms with or 
without regard to their actual location in core storage. 
He can, however, specify a starting location for his 
program. 

2. The processor assigns relative addresses to the 
program statements and constants, starting at the ad- 
dress specified by the programmer, or zero ( 00000 ) if 
not specified. The processor also indicates to the Link- 
age Loader whether these addresses are to be given 
upward, downward, or NO relocation, as explained 
below. 

3. When the program is loaded, the addresses arc 
adjusted by a relocation factor calculated and applied 
by the Linkage Loader. ( The adjusted addresses main- 
tain the same relative locations and relationships to 
each other as specified in the source program.) This 
subject is covered in more detail under "ORG — Ori- 
gin," in the subsection "Subprogram Control State- 
ments." 

Each address within the program is assigned a code 
by the processor, indicating to the Linkage Loader 
one of three types of relocation. When the Linkage 
Loader is executed, it calculates and applies to the ad- 
dress the relocation factor called for by the associated 
indicator. 



The three types of relocation factors that can be 
applied are: 
Upward 
Downward 

NO 

Upward Relocation 

Upward relocation means that the address in the object 
program will normally be incremented. For example, 
if the compiled origin of the object program is 00000 
and the relocation factor is 12,000, the program will be 
loaded starting at core-storage location 12000. The 
relocation factor is added to each load address and to 
each address within the program to which an upward 
relocation indicator is assigned by the processor. 

Of the three relocation types possible, upward re- 
location is the one most frequently applied. 

Downward Relocation 

Downward relocation means that the address in the 
object program will be decremented by a value cal- 
culated by the Linkage Loader. A downward reloca- 
tion indicator is assigned by the processor to those ad- 
dresses that refer to the common data area. 

NO Relocation 

no relocation means that the address in the object pro- 
gram is to be unchanged by the Linkage Loader. A 
no relocation indicator will be assigned by the proc- 
essor to those addresses whose absolute value is already 
supplied and must be maintained. For example, the 
addresses of index registers receive no relocation indi- 
cators. 



Definition of COMMON 

common is the formal name, predefined in the proc- 
essor's symbol table, of a relocatable work area that 
can be referenced by more than one subprogram. Cer- 
tain language conventions must be observed if sep- 
arately-assembled subprograms are to achieve com- 
patible addressing of shared data fields in common. 
During the assembly process, references to common 
are translated according to an addressing and reloca- 
tion convention designed to make these references 
suitable for resolution by the Linkage Loader. The 
convention chosen is the assignment of the value 99999 
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Figure 1. The Basic Operand Entries 



as the reference address of common during the assem- 
bly process. All relocatable addresses of data in com- 
mon are relative to 99999. For example, the 15th lo- 
cation downward in common is assigned the value 
99985, and appears as the same relative address in all 
subprograms. Labels referencing common are assigned 
downward relocation indicators for absolute adjust- 
ment by the Linkage Loader. 

Absolute adjustment involves changing the relative 
values of the labels (assigned to them by the proc- 
essor ) to absolute values in the relocated common data 
area. The adjustment factor applied is the difference 
between the value of common in the assembly process 
( 99999 ) and the absolute value of common determined 
by the Linkage Loader. Normally, the Linkage Loader 
will place common at the location represented by the 
value of the system symbol /ams/ ( Absolute Memory 
Size). However, the programmer can specify a dif- 
ferent absolute location for common by means of a 
base2 statement. (The interested reader will find a 
fuller discussion of this subject in the publication, 
System Monitor. ) 

The steps necessary to use common in a subprogram 
are discussed under "dav — Define Area in common," 
in the subsection "Declarative Operation Codes." 



Processing Options 

There are four processing options which can be exer- 
cised by the user: 

1. He can suppress the printing of the assembly list- 
ing ( on the Standard Print Unit ) . 

2. He can suppress the punching of the object deck 
( on the Standard Punch Unit ) . 

3. If there are no macro statements in the source 
deck, he can speed up the assembly process by indicat- 
ing this fact. 

4. He can suppress the diagnostic generation of an 
"M" flag for uses of index registers 14 and 15 when 
there is no true multiple definition. ( See note 1, under 
"Indexing with Address Adjustment." ) 

These options are indicated by means of additional 
parameters in the exeq card that calls the Autocoder 
processor. 

The four parameters are: 
noprt — Suppress printing 
nopch — Suppress punching 
nomac — No macros present 
noflg — Suppress "M" flag 
Any or all of these parameters may be used in the 
exeq card. They can appear in any order immediately 
following the exeq parameters required by the System 
Monitor. (See the publication, System Monitor, for 
details concerning the exeq card. ) 



Specification of parameters in the exeq card is con- 
cluded by the first blank encountered in the operand 
field. The following examples illustrate the format: 



OPERATION 



LABEL CODE 

MON$$ EXEQ 

MON$$ EXEQ 

MON$$ EXEQ 



OPERAND 

AUTOCODER, SOF, SIU, NOPRT 

AUTOCODER, , , NOMAC, NOPCH, 

NOFLG 

AUTOCODER, , , NOFLG, NOPRT, 

NOMAC, NOPCH 



Autocoder Multiple Compilation 

Autocoder can compile any number of programs with a 
single mon$$ exeq autocoder card. The output is the 
same as if it were produced by several separate com- 
pilations. 

Input for a multiple compilation consists of the 
mon$$ exeq autocoder card followed by the source 
decks to be compiled. No control cards are necessary 
between the end statement of one program and the first 
card of the next program if the programmer wants the 
subsequent compilation to receive standard treatment; 
that is, printing, punching, and normal macro and flag 
processing. 

A different set of processing options ( noprt, nopch, 
nomac or noflg ) can be specified for an ensuing pro- 
gram in a multiple compilation by placing an Option 
card after the preceding end statement. This card has 
the same requirements and options as the mon$j exeq 
autocoder card except that the label and operation 
fields, card columns 6-20, must contain blanks ( instead 
of mon$$ exeq ) . The processing options specified in this 
Option card will be applied until the next Autocoder 
end card is read by the processor. 

Autocoder multiple compilation has two potential 
advantages: 

1. It enables the programmer to process a series of 
source decks from the Alternate Input Unit as well as 
the Standard Input Unit. 

2. It bypasses the monitor processing which normally 
is necessary between compilations. 



Terminating the Object Program 

The object progam must terminate execution by means 
of one of the following instructions: 

b /eop/ Normal End of Program 
b /uep/ Unusual End of Program 

Both forms of termination are shown in Figure 2. Full 
details can be found in the publication, System Monitor. 
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64015 
SEONO PGLIN LABEL 



SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOD OPERAND 



PAGE 1 
CT AOORS INSTRUCTION 



SAHPL 
CARD FLAG 



1 AA020 

2 AA030 

3 S A040 

4 AA050 

5 AA060 

6 AA070 

7 AA080 

8 AA090 

9 AA100 

10 AAUO 

11 AA120 

12 AA130 

13 AA135 

14 AA140 

15 G AA140 

16 G 01510 

17 G 01520 

18 G 01530 

19 G 01580 

20 AA145 



TITLE SEQUENCE 
> THIS SUBPROGRAM CHECKS THE SEQUENCE OF THE PGLN/ FIELD 

• IF THE PGLN/ FIELD IS 99999, THE PROGRAM IS TERMINATED NORMALLY 

• A NON-ASCENDING SEQUENCE RESULTS IN AN UNUSUAL ENO OF PROGRAM. 
SEQROUTINE SBR EXITSEQRT65 

C PGLN/,3999993 IS THIS THE LAST ENTRY 
BE ENDOFJOB YES 
NOPMM 

B CHECKSEQ 

SW »-l2 SET FIRST TIHE NOP SWITCH TO BRANCH 

MLCMB PGLN/,PGLNH0LD#5 
EX1TSEQRT B EXIT - RETURN TO MAIN PROGRAM 



ENDOFJOB IOCTL TYPE, MESSAGE 

ENDOFJOB EQU » 

BZN •-11,/CTB/ 

BXPA /CNC/ 

DCW MESSAGE 

BZN «-U,/CTB/ 

B /EOP/ 



21 
22 



24 
25 



AA148 
AA150 
AA160 
AA170 
AA175 



NOTIFY OPERATOR OF END OF JOB 



NORMAL END OF PROGRAM 



C PGLN/.PGLNHOLD 

BH EXITSEQRT-12 BRANCH IF PGLN/ IS IN SEQUENCE 

B /UEP/ UNUSUAL END OF PROGRAM 



7 00000 G 00056 B 002 

11 00007 C PGLN/ 00153 002 
7 00018 J 00058 S 002 
1 00025 N 002 
7 00026 J 00101 002 

6 00033 , 00026 002 

12 00039 D PGLN/ 00158 P 003 

7 00051 J 00000 003 



00058 

12 00058 V 00058 /CTB/ 2 003 

7 00070 Y /CNC/ X 003 

5 00081 00126 003 

12 00082 V 00082 /CTB/ 2 004 

7 00094 J /EOP/ 004 

11 00101 C PGLN/ 00158 004 

7 00112 J 00039 U 004 

7 00119 J /UEP/ 004 
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SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOD OPERAND 



26 AA180 SEQR/ DEFIN SEQROUTINE SEQR/ LINKAGE SYMBOL FOR SUBPROGRAM 

27 AA185 MESSAGE DCW SEND OF J0B3.G CONSOL PRINTER NOTICE 

28 AA190 HALT 12345 EXAMPLE OF AN ERRONEOUS STATEMENT 

29 AA200 END 

30 3999993 

31 PGLNHOLD *0005 

NUMBER OF FLAGGED STATEMENTS 1 
28 

1410/7010 AUTOCODER. ..SYSTEM /MID/ 0001 
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Figure 2. A Page from an Assembly Listing 



Assembly Listing 

Each page of the assembly listing contains a page 
heading line and a column heading line. 

The page heading line contains the following infor- 
mation, from left to right: 

1. The date contained at location /dat/ (the system 
symbol for the five-position date field in the Resident 
Monitor ) 

2. Information supplied via headr card 



3. Page number in the listing 

4. The identification supplied by headr or reseq 
cards 

The column heading line is illustrated in Figure 2, 
which shows the assembly listing of a subprogram 
assembled by the 1410/7010 Autocoder processor. 
The subprogram contains a deliberate error contrived 
to exhibit Autocoder's diagnostic flagging system. Fig- 
ure 2 illustrates the following items, going from left 
to right in the column heading line: 
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1. SEQNO — Sequence Number: The sequence 
number of statements as they appear in the assembly 
listing. 

2. PGLIN — Page and Line Number: The page and 
line number as it appears in columns 1 through 5 of 
the cards in the source deck. Page and line numbers 
must consist of five non-blank characters and must ap- 
pear in ascending sequence. 

Statements generated by the macro generator will 
have a page and line number in this field supplied by 
the generator. These numbers have no relationship to 
the numbers of the hand-coded statements; they rep- 
resent the order in which the statements appear in the 
Macro Library. 

The space between the seqno and pglin columns of 
the listing are used by the processor to contain either 
an "S" or a "G," under the following conditions. 

S — The page and line number of the statement is 
not in ascending sequence in relation to the preceding 
source statement. This is only a warning to the pro- 
grammer that his source statements may be out of 
sequence. 

G — This character differentiates statements pro- 
duced by the macro generator from the hand-coded 
source statements. 

3. LABEL — Label: The contents of the label field, 
columns 6 through 15, of the Autocoder statement. 

4. OPCOD: The Operation Code, columns 16 
through 20, of the Autocoder statement. 

5. OPERAND: The contents of the operand field, 
columns 21 through 72, of the Autocoder statement. 

6. REL — Relocation Indicator: This is a code char- 
acter that indicates to the Linkage Loader the type 
of relocation to be applied to the element(s) in the 
statement. 

7. CT — Character Count: The length in characters 
of the assembled imperative statement, or the number 
of core-storage locations reserved for a constant de- 
fined in a declarative statement. 

8. ADDRS: The relative address assigned by the 
processor to the instruction or constant. This address 
is subject to relocation. 

9. INSTRUCTION: The assembled machine-lan- 
guage instruction or constants from which the object 
deck is constructed. 

10. CARD — Card Number: The sequence number 
of the card in which the associated constants or in- 
structions appear in the object deck. This sequence 
number is automatically computed and placed in col- 
umns 73-75 of each card in the object deck, in ascend- 
ing order. 



11. FLAG: An alphabetic character indicating an 
actual or possible programming error. As many as five 
flags can be assigned to one Autocoder statement. The 
flags provided are as follows: 

F — invalid statement Format 

M — Multiple definition of a label 

N — macro generation Note 

O — invalid Operation code 

R — Restricted operation code ( if not generated 
by a macro) 

U — Unidentified label in the operand 

W — Warning, general classification of error 

Details concerning the above flags can be found in 
Appendix A. The total number of flagged statements 
is indicated at the end of the assembly listing, followed 
by a line which contains the sequence number of each 
flagged statement, to a maximum of 20 numbers. The 
presence of any flag except "R" causes the processor 
to set the "no-go" switch during assembly. This setting 
of the "no-go" switch can cause a bypassing of all the 
source cards up to the next job. See the System Monitor 
publication. 

The assembly listing can be supplemented by a cross 
reference listing at the option of the user, by means 
of the pst statement. This listing analyzes the sub- 
program^) just assembled, and lists each label, fol- 
lowed by the sequence number of the statement in 
which it was defined, and the sequence number of 
each statement in which the label is used as a reference 
address. See "pst — Print Symbol Table," in the sub- 
section "Control Operation Codes," for a more detailed 
explanation. 

Note: The system symbol /lin/ controls the line 
count on the listing page. However, if this system sym- 
bol calls for the printing of less than 30 lines per pages' 
the processor will reject this direction and print the 
assembly listing at the normal 55 lines per page. See 
the System Monitor publication for details concerning 
this system symbol. 



Replacement Codes 

The Autocoder processor utilizes a second line (nor- 
mally blank ) in the assembly listing, for the representa- 
tion of non-printable characters. Each of these char- 
acters is represented by two characters, one printed 
above the other, at the appropriate place in the listing. 
These two-character substitutions are called replace- 
ment codes, and they appear most frequently as re- 
location indicators or operation modifiers. 
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The two-character replacement codes with their con- 
ventional graphic representations, card codes, and 
names are listed in Figure 3. 
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Card 






Code 


Graphic 


Code 


Name 
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12-0 


Plus Zero 
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Minus Zero 
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12-7-8 


Group Mark 
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+++ 
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Delta 
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<? or/6 
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Cent Sign or Substitute 


Blank 
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Left Bracket 
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11-5-8 


Right Bracket 
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N/ 


7-8 


Tape Mark 
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12-6-8 


Less Than 




G 
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6-8 

11-6-8 

5-8 


Greater Than 

Semicolon 

Colon 
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\ 


0-6-8 


Backslash 





Figure 3. Replacement Codes 



Coding Sheet 

The Autocoder Coding Sheet (Figure 4) provides a 
convenient form for coding source program statements. 
Column numbers on the coding sheet have a one-for- 
one correspondence to the columns on the card used to 
punch the source statements (Autocoder Input Card, 
Form A36199). 

Each line of the coding sheet is punched into a sepa- 
rate card. The source deck, therefore, consists of a 
sequenced set of punched cards containing a line-by- 
line representation of the coding sheets. 

The following paragraphs explain the function of 
each field. The heading information, Program, Pro- 
grammed By, and Date, are only for documentation, 
and are not punched. 



Identification (Card Columns 76-80) 

This five-position field can contain a name created by 
the programmer to identify the program. This identi- 
fication will be punched into 76-80 of the object deck 
only if it appears in a headr or reseq control card. ( See 
"Control Operation Codes.") However, the identifica- 
tion is not checked on the other Autocoder statements, 
and serves only to identify the program to which the 
card belongs. Special, as well as alphameric, characters 
are permitted. 

Page Number and Line Number (Card Columns 1-5) 

The page number (columns 1 and 2), in conjunction 
with the line number ( columns 3-5 ) , provides a means 
of sequencing the cards in the source deck. This enables 
the programmer to identify and correlate the entries 
on the coding sheet and assembly listing with the 
entries in the source deck. Alphabetic, as well as nu- 
meric, characters can be used. ( If the standard collat- 
ing sequence is not followed, the processor will place 
a sequence ( S ) flag next to the pglin field in the as- 
sembly listing, as previously explained. ) 

Label (Card Columns 6-15) 

This field, if used, contains the label being defined in 
this statement. 

Operation Code (Card Columns 16-20) 

This field contains the operation code. 

Operand (Card Columns 21-72) 

This field, if used, contains the operand element(s) of 
the statement. 

Note: Columns 73-75 should be left blank. 

COMMENTS 

Comments are remarks or notes written by the pro- 
grammer in the operand field. At least two blank spaces 
must separate a comment from the last character of 
the statement. The comment, punched in the source 
deck, appears in the assembly listing but is not con- 
tained in the object deck, and has no effect on the 
object program. 

COMMENTS CARD 

It may, at times, be helpful to insert an entire line of 
descriptive information. This is done by placing an 
asterisk in column 6 and using the balance of the line 
(up to column 72) for comments. When this line of 
information is punched into a card of the source deck, 
the asterisk will identify it to the processor as a com- 
ments card. The comments will be printed on a single 
line of the assembly listing at the point of encounter, 
which can be anywhere in the source deck. Comments 
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Figure 4. The Coding Sheet Form 



cards inserted in a series of chained instructions will 
break the chain. To avoid this, the operation code 
should be re-stated and the appropriate operand en- 



tered on the first source card following any comments 
cards. (Comments cards have no effect on the object 
program and are not included in the object deck. ) 
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Types of Operand Entries 



This section explains the form and use of the various 
entries permitted in the operand field of imperative, 
declarative, Linkage Loader, and control statements. 
The operand field of an Autocoder statement is used 
to specify a variety of information to the processor. 
The function of a specific entry is dependent upon the 
type of Autocoder statement in which it appears. The 
normal operand usage with each of the five types of 
Autocoder statements is as follows. 



STATEMENT TYPE 

IMPERATIVE 



DECLARATIVE 



LINKAGE LOADER 



CONTROL 



MACRO 



OPERAND CONTENTS 

Symbolic address(es) to be operated 
upon by the machine instruction, and 
a d-modifier, when required 
Constants, symbols, and/or control 
parameters necessary to declare the 
desired fields 

Symbolic ( or actual ) addresses and/or 
control parameters required to convert 
the object deck into absolute format 
Symbolic (or actual) addresses and 
constant information indicated by the 
operation code 

Parameters of the macro statement 
(These parameters are discussed in 
the section entitled, "The Macro Sys- 
tem." ) 

All permissible operand entries are explained and 
illustrated under the following headings: 
Basic Addresses 
Address Adjustment 
Indexing 
Literals 

Linkage Symbols 
System Symbols 
Miscellaneous 



Basic Addresses 

Basic addresses contained in the operand field of an 
Autocoder statement are the primary elements of 
information conveyed to the processor. They can be 
altered or modified by means of additional elements 
contained in the operand field. 

A basic address is the symbolic or actual representa- 
tion of a core-storage location of the data field or in- 
struction referred to by the Autocoder statement. 
A basic address can be in one of three forms : 

Symbolic 

Asterisk 

Actual 



Symbolic 

A symbolic address is an operand entry that appears 
elsewhere in the source program as a label. As a rule, 
this symbol can be defined as a label either before or 
after the Autocoder statement in which it appears as 
an address. The exceptions to this rule are as follows: 

1. All symbolic operands appearing in org, ltorg, 
and equ statements must have been previously defined 
within the same program. 

2. The symbolic address appearing in an rsv state- 
ment must precede any other use of this symbol in a 
program. ( See "rsv — Reserve.") 

3. The symbolic representations of index registers 
(XO, X1-X15) and the common data area (common), 
must never appear in the label field. They cannot be 
defined by the user because they are predefined labels 
in the symbol table maintained by the Autocoder proc- 
essor. 

The instruction in Figure 5 illustrates the use of 
symbolic addresses. The symbols total and accumu- 
late are defined as labels elsewhere in the program. 
The assembled instruction will cause the contents of 
the core-storage area labeled total to be moved to the 
area labeled accumulate. 

Note: A symbolic address will receive upward, 
downward, or no relocation, depending on the manner 
in which the symbol is defined. 
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Figure 5. Autocoder Instruction with Symbolic Addresses 



Asterisk (*) 

An asterisk ( 11-4-8 punch) can be used as a basic ad- 
dress in an Autocoder statement. When compiling the 
object program, the processor will replace the asterisk 
with the relative core-storage address of the last char- 
acter of the instruction or data field created by the 
statement in which it appears. However, if an asterisk 
address is used in a statement that does not cause the 
generation of an instruction or data area in the object 
program, the value substituted for the asterisk will be 
the current location in the object program. 
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These uses of the asterisk address are illustrated by 
means of the three Autocoder statements in Figure 6, 
and are discussed in the order of their appearance. 



Line 

3 5 


Label 

6 


IS 


Operation 
16 20 


21 25 30 


35 


40 \ 


2 


1 
, , , , , i . , , 


MZ..C.A. 


*,),W.KA.R.£A S 


i 
, , , , . i , , , 


L.T.0.R.6 




0,3. 


i 




new, , 


* ^ 


0,4. 









Figure 6. Asterisk Addresses in Autocoder Statements 

1. The first statement in Figure 6 illustrates the use 
of the asterisk in an imperative instruction. Assume 
that this instruction is assigned to core-storage posi- 
tions 12340-12351 and that the reference address of 
wkarea is 13598 (the low-order position). The as- 
sembled instruction is D1235113598T. 

2. The second statement in Figure 6 illustrates the 
use of the asterisk in an Autocoder control statement. 
In this case, the asterisk represents the current address 
in the processor's relative location counter. For ex- 
ample, if the last address assigned was 12351, the rela- 
tive location counter will contain the address 12352 
( the representative value of the asterisk ) . 

It should be noted that no data or instructions are 
generated by the asterisk in this statement. The value 
the asterisk represents is the location where a specific 
function is to be performed. In this case, the asterisk 
means the beginning address for the assignment of 
previously -encountered literals in the subprogram. 
( Literals are discussed later in this section; the ltorg 
statement is discussed under "Control Operating 
Codes.") 

3. The third statement in Figure 6 illustrates the 
use of the asterisk in a declarative statement. (The 
dcw statement is discussed under "Declarative Opera- 
tion Codes.") In this case, a five-position address con- 
stant is defined which is the low-order address of the 
generated field. For example, if the asterisk repre- 
sented the address 12356, this address would be con- 
verted by the processor into a five-position constant 
assigned to positions 12352-12356, with a word mark 
over the high-order position. 

The asterisk address is used most often in imperative 
statements with address adjustment, as a means of re- 
ducing the number of labels required in a program. 
(See "Address Adjustment.") 

Note: Asterisk addresses are assigned upward re- 
location indicators. 

Actual 

An actual address is the numeric designation for a 
core-storage location. Thus, the actual addresses of a 



1410 or 7010 with 40,000 core-storage positions range 
from 00000 to 39999. In coding, the high-order zeros 
of actual addresses can be omitted (except for loca- 
tion 00000, which must be represented by at least one 
zero ) . 

Figure 7 illustrates the mixing of actual and sym- 
bolic addresses. The statement represents a data move 
of the contents of the area whose low-order position 
is at location 22101 to the area labeled money. 

Caution 

All programs written to be run within the frame- 
work of the 1410/7010 Operating Systems are re- 
locatable. Since actual addresses are assigned a no 
relocation indicator, the programmer must exercise 
extreme caution when using actual addresses. This 
is especially true when previously-coded programs 
| written for the ibm 1410 are being converted for use 
with the Operating System. 
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Figure 7. An Actual and a Symbolic Address 



Address Adjustment 

A basic address, specified in the operand field, can be 
altered or modified to refer to a different position of 
core storage. The basic address can be altered during 
program assembly by means of address adjustment; 
during program execution by means of indexing. Ad- 
dress adjustment is discussed below; indexing will be 
explained in the next subsection. 

Address adjustment enables the programmer to ref- 
erence a location which is a specified number of core- 
storage positions away from a basic address. Address 
adjustment is indicated by writing after the basic 
address a plus or minus sign followed by a one-to-five- 
digit number that specifies the adjustment factor. 

Assume that in Figure 8 the label manno is assigned 
address 15000 and total is assigned the location 
20075. The assembled instruction is A1501220075. The 
contents of manno +12 (15012), not manno (15000), 
will be added to total. 
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Figure 8. Address Adjustment 
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The Form *+X00 

Asterisk and actual basic addresses, as well as symbolic, 
can be address adjusted with similar results for the 
same adjustment factor. However, there is a special 
adjustment factor unique to the asterisk address, whose 
use is limited to org, ltorg, and basei statements. This 
special form is * + X00 ( asterisk-plus-X-zero-zero ) . Its 
function in org and ltorg statements is to advance the 
processor's relative location counter to the address of 
the next hundreds position in core storage during pro- 
gram assembly (Figure 9). The basei * + X00 value is 
resolved by the Linkage Loader. 

For example, if the relative location counter contains 
07214 when the processor encounters the statement in 
Figure 9, the counter will be automatically incremented 
to 07300, and subsequent entries will be assigned core- 
storage locations beginning at this address. The org 
and ltorg statements are discussed in the subsection, 
"Control Operation Codes." The basei statement is dis- 
cussed in the subsection, "Declarative Operation 
Codes." 

Note: The basei * + X00 statement must appear pre- 
vious to the org * + X00 card or the "no-go" switch will 
be set. 



ter, (3) index an address, and (4) combine indexing 
with address adjustment. 

Addressing an Index Register 

Index registers are symbolically referenced within the 
operand of an Autocoder statement by placing an X 
before its number. Thus, the predefined symbols XI 
through X15 designate index registers 1 through 15, 
respectively. 

Autocoder statements that initialize or modify the 
contents of an index register contain the notation for 
the index register as a basic address ( Figure 10 ) . 

In Figure 10, the operation code "za" moves the con- 
tents of the location labeled eighty into index register 
10 and inserts high-order zeros. Thus, if eighty contains 
" + 80", the contents of index register 10 will become 
+ 00080, after the execution of the assembled instruc- 
tion. ( The plus sign will be placed in storage as ab bits 
over the units position. ) 

Note: When an index register is used as a basic ad- 
dress, it is assigned a no relocation indicator. 
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Figure 9. Use of the Special Form * + X00 
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Figure 10. Entering a Numeric Value into an Index Register 



Multiple Adjustment Factors 

Basic A- and B-addresses can be address adjusted, and 
both can contain more than one address adjustment 
notation. The number of adjustment factors permitted 
is limited only by the length of the operand field (up 
to card column 72 ) . 



Indexing 

Indexing is a form of address modification which takes 
effect at the time the object program is executed. Auto- 
coder statements can be used to initialize or modify the 
contents of an index register, or indexing can be used 
to modify an address within a statement. (See either 
the 1410 or 7010 Principles of Operation reference man- 
ual, listed as prerequisites, for a complete description 
of index register usage. ) 

The following discussion explains how the Autocoder 
language can be used to ( 1 ) address an index register, 
( 2 ) initialize or modify the contents of an index regis- 



Indexing an Address 

A basic address is indexed by following the basic ad- 
dress with a plus sign and the notation for the index 
register (Figure 11). 

In Figure 11, assume that the basic address manno 
is relocated to core-storage location 15000 (by the 
Linkage Loader). If index register 10 contains 00100 
(or +00100), the effective address of manno + X10 is 
15100. Thus, the operation code "mlc" will cause the 
data at location 15100 to be moved to the location 
labeled accum. However, if index register 10 contains 
-00100, the effective address of manno + X10 is 14900. 
Thus, the data at location 14900 is moved to accum 
by the execution of the assembled instruction. 

Both the A-address and the B-address can be indexed. 
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Figure 11. Indexing an Address 
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Indexing with Address Adjustment 

Indexing and address adjustment are permitted in the 
same operand. The indexing indicator can follow or 
precede the adjustment factor notation ( Figure 12 ) . 

The actual location represented by the A-address in 
Figure 12 will be the basic address ( total ) , minus 12, 
plus the contents of index register 1. Assuming that 
total is the label for location 03101 and that index 
register 1 contains 00080, the address of total — 12 
+ X1 will be 03101-12 + 00080, or 03169. However, 
the assembled instruction will be D030Y900140C, as- 
suming that accum is the label for location 00140. The 
"Y" in the tens position of the A-address is an 8-punch 
with a zero-zone punch. The zero-zone punch in the 
tens position is the tag for index register 1. 



Line 
3 5 


Label 

6 


15 


Operation 
16 20 


21 25 30 35 


40 \ 


0,l ± _ 
0,2 


1 
1 . , , 


t\L.C. , 


TOT. A.L-.1.Z.+.1L1.*. ACCUM . . A 


1 
1 , , , 







Figure 12. Address Adjustment and Indexing 



Note 1: Index registers 14 and 15 are reserved for 
use by the System Monitor. If index registers 14 and 
15 are used in an Autocoder program, the processor 
will properly assemble all references to them, but will 
flag these references with an "M" (multiple defini- 
tion), unless the noflg parameter is supplied in the 
appropriate exeq or Option card. 

By convention, index register 13 is designated as the 
index register used for linkage with subroutines. The 
reader will find further details in the publication, 
System Monitor. 

Note 2: The programmer can assign a label to an 
index register and subsequently reference it, for the 
balance of the assembly run, by his own symbolic 
designation. ( See "equ — Equate," under "Declarative 
Operation Codes.") 

Note 3: The special symbolic adjustment notation, 
X0, indicates to the processor that the associated basic 
address should be assembled without its tag. That is, 
if a label has been established in the program as 
relating to an address that is to be adjusted by an 
index register, it may be used without index register 
adjustment by following the symbolic address with 
4- X0 ( plus-X-zero ) . See "da — Define Area," under 
"Declarative Operation Codes," for an example of 
index negation. 



Literals 

Literals permit the programmer to specify a pre- 
viously-undefined constant within an imperative 



statement that refers to the constant. Autocoder's 
ability to process literals enables the programmer to 
specify a field of constant data, and in the same im- 
perative statement perform a function using the spec- 
ified field. 

As the processor allocates core storage, it automati- 
cally reserves a field in which it constructs the constant 
data. When the imperative statement is translated into 
machine language, the address to which the constant 
data was assigned becomes a basic address referencing 
the field at its low-order position. The processor as- 
signs a word mark to the high-order position of the 
constant field. Literals can be address adjusted and/ 
or indexed. 

All literals are assigned upward relocation indicators. 

The four kinds of literals are discussed under the 
following headings: 
Numeric Literal 
Alphameric Literal 
Area Defining Literal 
Address Constant Literal 

Note: Neither a literal nor its label can be used in 
the operand field of an equ statement. (See "equ — 
Equate," under "Declarative Operation Codes.") 

Numeric Literal 

A numeric literal represents a data field of numbers 
with a sign. Its form in a statement has the following 
characteristics : 

1. It is coded as the basic A- or B-address. 

2. It is preceded by a plus or minus sign. When it 
is assigned to core storage, the sign is placed over the 
units position. 

3. It is an integer whose length is limited only by 
the available operand positions. 

4. Blanks and other non-numeric characters are not 
permitted within a numeric literal. 

In Figure 13, the instruction causes the value " + 80" 
to be added to the contents of the core-storage loca- 
tion labeled total. 
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Figure 13. Use of the Numeric Literal 

When a numeric literal does not exceed nine digits 
in length ( excluding the sign ) , it is assigned a relative 
location only once per program segment (a program 
is separated into segments by ltorg, spend, or end 
statements), no matter how often it appears in the 
source program. Longer numeric literals are assigned 
a relative location each time they are encountered in 
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the source program. Consequently, to conserve core 
storage, in cases where multiple use of a "long literal" 
is necessary, it should be defined as a dcw. ( See "dcw 
— Define Constant with Word Mark," in the section 
"Declarative Operation Codes.") 

If an unsigned numeric literal is desired, it must be 
entered as an alphameric literal (see below). 

Alphameric Literal 

An alphameric literal can consist of one or more char- 
acters, including the blank. The literal must be pre- 
ceded and followed by the @ character (4-8 punch). 
The @ character is permitted within the body of the 
literal itself; however, a comment on the same line 
must not contain the @ character. Also, only one alpha- 
meric literal can appear in the operand field. These 
considerations are necessary because the processor as- 
sumes everything between the initial and terminal @ 
characters in the operand field to be part of an alpha- 
meric literal. 

Note: The word separator character (0-5-8 punch) 
must never be coded as the first character of an alpha- 
meric literal. 

In Figure 14, the alphameric literal june 14, 1964, is 
compared to the contents of the core-storage location 
labeled flagday. 
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Figure 14. Use of the Alphameric Literal 

An alphameric literal, one to nine characters in 
length (excluding preceding and terminal @ char- 
acters), is assigned a relative location only once in a 
program segment, no matter how often it is used in the 
source program. Longer alphameric literals are as- 
signed a relative location each time they are encoun- 
tered in the source program. Consequently, to conserve 
core storage, in cases where multiple use of a long 
literal is necessary, the literal should be entered as a 
dcw. ( See "dcw — Define Constant with Word Mark." ) 

Area Defining Literal 

The area defining literal affords a convenient method 
for simultaneously defining and labeling a field of 
blanks within the same Autocoder instruction in which 
it is required. The generated field is assigned a relative 
location along with other literals in the subprogram, 
and has a word mark in its high-order position. The 
field can be referenced by its associated label in other 
statements in the subprogram. 

The area defining literal can be specified only as a 
basic address in an imperative statement ( Figure 15 ) . 



It consists of a user-created label, followed by a pound 
sign ( # ) character ( 3-8 punch ) , and a number speci- 
fying the length of the field required. Since the pound 
sign notation is used to define the label only once, it 
should not be attached to the label in other references. 

Figure 15 illustrates how an area defining literal can 
be used in an Autocoder statement. This literal causes 
the processor to allocate ten successive positions of 
core storage, and label the area buffertwo. Ten suc- 
cessive blanks will be loaded into storage at object 
program load time. Assuming that amount refers to lo- 
cation 00796, and buffertwo refers to location 00596 
(the low-order position of the field), the assembled 
machine-language instruction that moves the contents 
of amount to the area buffertwo is D0079600596C. 

Note: The following restrictions should be con- 
sidered when using a label created by means of the 
area defining literal: 

1. When the processor encounters a ltorg or spend 
statement, it terminates the availability of previously 
defined labels that were created by means of area de- 
fining literals. Thus, subsequent references to the label 
will not be effective. ( See "ltorg — Literal Origin," 
and "spend — Subprogram End." ) 

2. A symbol defined by an area defining literal must 
never appear in the label field. 

3. The area which can be reserved by an area de- 
fining literal is limited to 500 positions of core storage. 
If this limit is exceeded, the processor will reserve only 
the maximum ( 500 positions ) , and attach an "F" flag 
to the statement in which it appears. 
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Figure 15. Use of the Area Defining Literal 

Address Constant Literal 

When a label is used in a source program, the machine 
address assigned to it by the processor can be defined 
as a constant (hereinafter referred to as an address 
constant), and used as such by the programmer. The 
label that is to be defined as an address constant is 
written as a symbolic basic address of an instruction, 
with a plus sign preceding this symbol. This signals the 
processor to create the address constant in a five- 
position area of core storage. The area contains the 
machine address assigned to the label by the processor. 
The relative location assigned to the address constant 
becomes the basic address represented by the address 
constant literal. ( See (2), Figure 16. ) 

Figure 16 illustrates how an address constant literal 
can be used. (The numbers in column 36 correspond 
to the numbered references in the text which describe 



18 



Line 

5 5 


Label 

6 15 


Operation 
16 20 


21 25 30 35 40> 


0,1, 


EXIT. . ! 


A. . . , 


A.,.R (ft . . , .1 


0,2 




















\ 


0,3, 






. 














\ 


0,4. 






. 














\ 


0,5, 


AJD.COM ! 




ML.AI. . 


+£.X.IT.,.IMS.T.+.S 






G) ■ 






{ 


0,6, 




















( 


0,7. 




















\ 


0,8, 






. 














1 


0,9, 


iMsr. . ! 




B. , . . 


0. 






ft 






) 


1.0. 














■ i 






> 



Figure 16. Use of an Address Constant Literal 



the functions performed by the statements in the 
figure. ) 

1. Assume that the label exit is assigned by the 
processor to location 20600. 

2. When the processor assembles the instruction 
labeled adcon, the address of the symbolic operand 
+ exit will be assigned a five-position area in core 
storage in a manner similar to other literals. That is, 
the address of exit ( 20600 ) becomes the constant data 
field addressed by the statement. 

3. Assume that 32797 is the location of the address 
constant literal and the location of the instruction 
labeled inst is 11401. The assembled machine-language 
instruction of adcon will be 6327971 1406A. 

When the instruction labeled adcon is executed in 
the object program, the address constant 20600 is 
moved to 11406. The instruction labeled inst now be- 
comes J20600b. When the instruction is executed, an 
unconditional branch to exit takes place. Thus, the 
programmer can write an instruction which moves an 
actual address into the operand of another instruction 
at program execution time. 

Note 1: If address adjustment and/or indexing are 
used in the operand with an address constant literal, 
they modify the address of the address constant literal, 
not the constant itself. ( That is, in the example given, 
address 32797, not 20600. ) Both addresses will be as- 
signed upward relocation indicators. 

Note 2: The address constant (20600) will be un- 
signed in core storage. 

An address constant can also be created by means 
of the dcw statement. See "dcw — Define Constant 
with Word Mark." 



grams and converts them to absolute format. The use 
of linkage symbols facilitates the communication by 
indicating to the Linkage Loader that a reference ad- 
dress from a different subprogram is required. 
The two formats of the linkage symbol are: 

1. A conventional label (up to ten alphameric char- 
acters in length ) which can be established as a linkage 
symbol only by appearing either as the name parameter 
in the title card or as the label of a defin statement. 

It can be referred to, in an assembly, only by one of 
the following statements. These statements are dis- 
cussed later, under their individual headings: 

dcwf — Subprogram Address Constant 

dcws — Subprogram Branch Instruction 

basei — Base Address of the Subprogram 

base2 — Base Address of COMMON 

prtct — Protect 

call — Subprogram Call 

This type of linkage symbol is used to reference en- 
tire subprograms by means of operation codes men- 
tioned in its description. Its specification is described 
in the discussion of statements permitting its use. 

2. A special five-position symbol consisting of four 
alphameric characters ( the first of which must be, al- 
phabetic) with a slash (/) in the fifth position. It is 
established as a linkage symbol by appearing as the 
label in a defin statement. This type of linkage symbol 
can be used in the operand field of any Autocoder 
statement except equ, org, ltorg, end and spend; it 
cannot be indexed or address adjusted. 

It is imbedded within subprogram instructions, and 
is not assigned an address, but is placed in its corre- 
sponding position in the generated machine instruction, 
as supplied in the Autocoder statement. 

This second type of linkage symbol can be used to 
communicate with a subprogram at a point designated 
by the symbol. When the instruction is processed by 
the Linkage Loader the linkage symbol is converted 
into an absolute machine address. 

Figure 17 illustrates the use of a linkage symbol in 
an Autocoder instruction. The assembled instruction 
will be Alabe/00029. The Linkage Loader will deter- 
mine and supply the absolute value for labe/. Thus, 
the instruction will be loaded as Axxxxx00029, where 
xxxxx is the absolute address supplied by the Linkage 
Loader.* 

Note: Linkage symbols are assigned a no reloca- 
tion indicator. 



Linkage Symbols 

Relocatable subprograms that have been independ- 
ently compiled, but designed to run together, require 
communication. This communication is supplied by 
the Linkage Loader when it combines the subpro- 
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Figure 17. Use of the Five-Position Linkage Symbol 
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System Symbols 

Various elements of the Resident Monitor (including 
the Resident iocs ) can be referenced in the Autocoder 
language by the use of their assigned system symbols. 
All system symbols have the format /abc/, where abc 
is the symbolic name of a location within the Resident 
Monitor. System symbols are discussed in detail in the 
publication, System Monitor. 

System symbols are treated by the Autocoder proc- 
essor in the same manner as linkage symbols. That is, 
they are passed intact to the Linkage Loader, where 
they are resolved into absolute addresses. 

Figure 18 illustrates the use of a system symbol in 
an Autocoder instruction. The assembled instruction 
will be D/DAT/00029T. The Linkage Loader will 
search its table of system symbols and substitute the 
absolute value for /dat/. Thus, the instruction will be 

V 

loaded as Dxxxxx00029T, where xxxxx is the absolute 
value for the system symbol, /dat/. 

Note: A system symbol is assigned a no relocation 
indicator. ( The absolute addresses for system symbols 
are a permanent part of the Linkage Loader's symbol 
table. ) 



Figure 19 the second A (add) instruction is chained. 
It takes its addresses from the A- and B-address 
registers. 
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Figure 18. Use of the System Symbol 



Miscellaneous 

There are several additional elements that are valid in 
the operand field. These elements are discussed under 
the following headings: 

Operation Modifiers ( d-characters ) 

Blank Operand 

Zero as a Basic Address 

Special Operand Elements 

Operation Modifiers (d-Characters) 

The programmer using the Autocoder language is re- 
quired to supply the operation modifiers associated 
with certain conditional branch instructions. They are 
indicated under "Logical Operations" in Appendix D 
of this publication. The reader is also directed to the 
appropriate sections in either of the Principles of 
Operation manuals listed as prerequisite reading. 

Blank Operand 

A blank operand is valid in the following types of 
operations : 

1. In operations where valid A- and /or B -addresses 
are supplied by the chaining method. For example, in 



Line 
3 5 


Label 
6 15 


Operation 
16 20 


21 25 30 35 40 ) 


0, 1, 
0.2 


1 

1 


A> , , , 


AtLPAAjj&EJA , ^^^ _^_, ... ... .... J 


0,3. 


I 


A, , , , 


] 



Figure 19. Blank Operand when Chaining 

2. In operations that do not require an operand; for 
example, an org statement that directs the processor 
to use the address in the high assignment counter plus 
one. ( See "org — Origin," under "Control Operation 
Codes"; also, "nop" and "nopwm" under "Imperative 
Operation Codes," for additional examples of the use 
of the blank operand. ) 

Zero as a Basic Address 

A zero in the operand field is treated as the value 00000 
by the processor. Address adjustment and indexing 
can be used. If this value is address adjusted by a neg- 
ative factor, a complement number is created. For 
example, the operand — 5 means address 99995 ( Fig- 
ure 20). 

In Figure 20 the contents of the location indicated 
by the value 00000 — 5, plus the contents of index 
register 10, will be added to hold. The assembled ma- 
chine instruction will be A99RR501000 (assuming 
hold is assigned address 01000). The Rs in the A- 
address are the result of B bits being placed over 9s 
in the tens and hundreds position to tag index register 
10. 

A no relocation indicator will be assigned by the 
processor to a zero address. 
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Figure 20. Use of the Zero Operand 

Special Operand Elements 

Some Autocoder statements require certain special 
types of information which must appear in the oper- 
and field in a specified manner. These statements are 
listed below. (The interested user is directed to the 
appropriate subsection of this publication for a full 
explanation of each statement's format requirements. ) 

1. da and dav statement parameters 

2. da and dav subentries 

3. title statement 

4. headr statement 
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Autocoder Operation Codes 



This section explains the functions performed by Auto- 
coder operation codes, and the permissible formats of 
the statements in which they appear. ( Macro operation 
codes, because they are a special form, are explained 
separately in the next section. ) 

Every statement written in the Autocoder language 
must have a specified or implied operation code in the 
operation field (card columns 16-20). Every permis- 
sible operation code belongs to one of four major 
categories and is discussed in this section according 
to the functional grouping of the Autocoder statement 
it represents. The four major categories and their func- 
tional groupings are as follows: 

Imperative Operation Codes 
Symbolic Machine Instructions 
Special Imperative Statements 

Declarative Operation Codes 

Linkage Loader Operation Codes 

Control Operation Codes 
Assembly Control Statements 
Subprogram Control Statements 



Imperative Operation Codes 

Imperative operation codes appear in Autocoder state- 
ments that are translated by the processor into ma- 
chine instructions. 



Symbolic Machine Instructions 

A symbolic machine instruction is an Autocoder state- 
ment that is translated by the processor into a 
machine-language instruction. Permissible symbolic 
machine instructions include all arithmetic and gen- 
eral data operations, as well as most miscellaneous 
and branch operations not related to input/output 
channel status indicators. The processor attaches an 
"R" flag to mnemonics which can violate the conven- 
tions of the Operating System. These mnemonics are 
listed in Figure 21, which groups and lists every opera- 
tion code that can be handled by the 1410/7010 Auto- 
coder processor. 

The machine-language equivalents of all valid Auto- 
coder operation codes are grouped and listed in 
Appendix D. 

Details concerning the form and use of machine 
instructions and the operations they perform can be 
found in the following publications: 



IBM 1410 Principles of Operation, Form A22-0526 
IBM 7010 Principles of Operation, Form A22-6726 



Special Imperative Statements 

Two special imperative operation codes have unique 
meanings for the Autocoder processor, and are pro- 
vided to add flexibility to program coding. 

NOPWM — No Operation; Word Mark 

The nopwm operation code results in the creation of a 
nop instruction, and directs the processor not to as- 
sign a word mark to the operation code of the next 
sequential instruction. The operand field of this state- 
ment is left blank (Figure 22). 

At assembly time, the nopwm instruction (Figure 
22) causes the processor to insert in the object pro- 
gram, the machine operation code N ( No Operation ) 
with a word mark, followed by an unconditional 
branch instruction (J01950) without a word mark. 
The assembled instruction will be NJ01950b. ( Assume 
next is assigned to location 01950.) At execution 
time the branch will be inoperative, and the machine 
will proceed to the next sequential instruction. 

Other instructions in the subprogram can be used 
to set or clear the word mark over the operation code 
of the branch instruction, as needed. If there is no 
word mark, the branch instruction is ignored; if 
the word mark is present, the branch instruction 
is executed. Thus, the nopwm operation permits the 
programmer to set "No Op" switches easily. 

Note: The effect of nopwm before a dcws state- 
ment is the same as a simple nop. That is, an N is 
generated and a word mark is assigned to the J opera- 
tion code of the seven-position dcws. 

NOP — No Operation 

The nop operation code results in the creation of a 
one-character machine instruction. The operand field 
must be blank ( Figure 23 ) . 

The nop statement can also be used to define a pro- 
gram switch. As shown in Figure 23, the processor 
will translate the mnemonic nop to N ( No Operation ) 
with a word mark. The unconditional branch instruc- 
tion will be translated as J01950b, with a word mark 
over the "J" operation code. (Assume next to be the 
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CONTROL OPERATION CODES 



ASSEMBLY CONTROL CODES 



Mnemonic 



HEADR 
RESEQ 
EJECT 
PST 



Meaning 



Reader Line 

Resequence Object Deck 

Eject Page 

Print Symbol Table 



SUBPROGRAM CONTROL CODES 



ORG 
LTORG 
END 
SPEND 



Origin 

Literal Origin 

End of Source Program 

Subprogram End 



DECLARATIVE OPERATION CODES 



SUBPROGRAM DECLARATIVE CODES 


DA 

DCW 

DC 

DS 

EQU 


Define Area 

Define Constant with WM 

Define Constant 

Define Symbol 

Equate 


LINKAGE LOADER OPERATION CODES 


TITLE 

BASE1 

BASE2 

CALL 

DEFIN 

PRTCT 


Title of Subprogram 

Base Address 

Base Address of COMMON 

Call Subprogram 

Definition 

Protect Definitions 


SUBPROGRAM LINKAGE CODES 


DCWF 
DCWS 


Subprogram Address Const 
Subprogram Branch Instr 


COMMON DECLARATIVE CODES 


DAV Define Area in COMMON 
RSV J Reserve Label in COMMON 



IMPERATIVE OPERATION CODES 



ARITHMETIC OPERATION CODES 



A 

S 

M 

D 

ZA 

ZS 

FA 

FS 

FM 

FD 

FRA 

FST 



Add 

Subtract 

Multiply 

Divide 

Zero and Add 

Zero and Subtract 

Floating Add 

Floating Subtract 

Floating Multiply 

Floating Divide 

Floating Reset and Add 

Floating Store 



COMPARE AND LOOKUP OPERATIONS 



C 

LL 

LE 

LLE 

LH 

LEH 

LLH 



Compare 
Lookup Low 
Lookup Equal 
Lookup Low or Equal 
Lookup High 
Lookup Equal or High 
Lookup Low or High 



IMPERATIVE CODES (Cont'd) 



MOVE OPERATION CODES 


Mnemonic 


Meaning 


MLNS 


Move Left Numeric Single 


MLZS 


Move Left Zone Single 


MLCS 


Move Left Charac Single 


MLWS 


Move Left WM Single 


MLNWS 


Move Left Num and WM Single 


MLCWS 


Move Left Charac and WM Single 


MLZWS 


Move Left Zones and WM Single 


MLNA 


Move Left Num to A-FId WM 


MLZA 


Move Left Zones to A-FId WM 


MLCA 


Move Left Charac to A-FId WM 


MLWA 


Move Left WMs to A-FId WM 


MLNWA 


Move Left Num and WM to A-FId WM 


MLZWA 


Move Left Zones WM to A-FId WM 


MLCWA 


Move Left Charac and WM to A-FId WM 


MLNB 


Move Left Num to B-FId WM 


MLZB 


Move Left Zones to B-FId WM 


MLCB 


Move Left Charac to B-FId WM 


MLWB 


Move Left WM to B-FId WM 


MLNWB 


Move Left Num and WM to B-FId WM 


MLZWB 


Move Left Zones and WM to B-FId WM 


MLCWB 


Move Left Charac and WM to B-FId WM 


MLN 


Move Left Numeric 


MLC 


Move Left Characters 


MLZ 


Move Left Zones 


MLW 


Move Left Word Marks 


MLNW 


Move Left Num and WMs 


MLZW 


Move Left Zones and WMs 


MLCW 


Move Left Charac and WMs 


MRN 


Move Right Numeric 


MRZ 


Move Right Zones 


MRC 


Move Right Characters 


MRW 


Move Right Word Marks 


MRNW 


Move Right Num and WMs 


MRZW 


Move Right Zones and WMs 


MRCW 


Move Right Charac and WMs 


MRNR 


Move Rt Num to A-FId RM 


MRZR 


Move Rt Zones to A-FId RM 


MRCR 


Move Rt Charac to A-FId RM 


MRWR 


Move Rt WMs to A-FId RM 


MRNWR 


Move Rt Num and WMs to A-FId RM 


MRZWR 


Move Rt Zones and WMs to A-FId RM 


MRCWR 


Move Rt Charac and WMs to A-FId RM 


MRNG 


Move Rt Num to A-FId GM-WM 


MRZG 


Move Rt Zones to A-FId GM-WM 


MRCG 


Move Rt Charac to A-FId GM-WM 


WRWG 


Move Rt WM to A-FId GM-WM 


MRNWG 


Move Rt Num and WM to A-FId GM-WM 


MRCWG 


Move Rt Charac and WM to A-FId GM-WM 


MRZWG 


Move Rt Zones and WM to A-FId GM-WM 


MRNM 


Move Rt Num to RM or GM in A 


MRZM 


Move Rt Zones to RM or GM in A 


MRCM 


Move Rt Charac to RM-GM in A 


MRWM 


Move Rt WMs to RM-GM in A 


MRNWM 


Move Rt Num and WMs to RM-GM in A 


MRZWM 


Move Rt Zones and WMs to RM-GM in A 


MRCWM 


Move Rt Charac and WMs to RM-GM in A 


MCS 


Move Charac and Suppress Zeros 


MCE 


Move Characters and Edit 


SCAN OPERATION CODES 


SCNRR 


Scan Rt to A-FId RM 


SCNRG 


Scan Rt to A-FId GM-WM 


SCNRM 


Scan Rt to A-FId RM or GM-WM 


SCNR 


Scan Rt to WM in A- or B-FId 


SCNLA 


Scan Left to A-FId WM 


SCNLB 


Scan Left to B-FId WM 


SCNL 


Scan Left to WM in A- or B-FId 


SCNLS 


Scan Left to Single Position 



IMPERATIVE CODES (Cont'd) 



LOGICAL OPERATION CODES * 


Mnemonic 


Meaning 


B 


Branch Unconditionally 


BU 


Branch If Compare Unequal 


BE 


Branch if Compare Equal 


BL 


Branch if Compare Low 


BH 


Branch if Compare High 


BCE 


Branch if Charac Equal 


BBE 


Branch if Bit Equal 


BAV 


Branch if Arith Ovfl 


BDV 


Branch if Divide Ovfl 


BZ 


Branch if Zero Balance 


BW 


Branch if Word Mark 


BZN 


Branch if No Zones 


BWZ 


Branch if WM and No Zones 


BXO 


Branch if Exponent Ovfl 


BXU 


Branch if Exponent Unfl 


MISCELLANEOUS OPERATION CODES 


NOP 


No Operation 


NOPWM 


No Opn, Suppress WM 


SAR 


Store A-Register 


SBR 


Store B-Register 


SW 


Set WM at A-Field 


CW 


Clear Word Mark 


CS 


Clear Storage 


STC 


Store Time Clock 


SR 


Store Register 


STCPU 


Store CPU Status 


RSCPU 


Restore CPU Status 


RESTRICTED OPERATION CODES * 


BEX1 


Branch Ext Indie Chan 1 


BEX2 


Branch Ext Indie Chan 2 


BEX3 


Branch Ext Indie Chan 3 


BEX4 


Branch Ext Indie Chan 4 


BOL1 


Branch Ovlp Proc Chan 1 


BOL2 


Branch Ovlp Proc Chan 2 


BOL3 


Branch Ovlp Proc Chan 3 


BOL4 


Branch Ovlp Proc Chan 4 


BB1 


Branch if Binary Cd Chan 1 


BB2 


Branch if Binary Cd Chan 2 


BPCB 


Branch if Prntr Carr Busy 


BPCB1 


Branch if Prntr Busy Chan 1 


BRCB2 


Branch if Prntr Busy Chan 2 


BCV 


Branch if Prntr Carr Ovfl 


BCV1 


Branch if Carr Ovfl Chan 1 


BCV2 


Branch if Carr Ovfl Chan 2 


BC9 


Branch if Carr Chan 9 


BC9I 


Branch if Carr Chan 9 Chan 1 


BC92 


Branch if Carr Chan 9 Chan 2 


BXPA 


Branch and Exit Priority Alert 


BEPA 


Branch and Enter Priority Alert 


JID 


Test and Branch 


BPI 


Priority Test and Branch 


STATS 


Store and Restore Status 


SSF 


Select Stackr and Feed 


CC 


Prntr Carriage Control 


BSP 


Backspace Tape 


WTM 


Write Tape Mark on Tape 


RWD 


Rewind Tape 


RWU 


Rewind and Unload Tape 


CU 


Control Unit 


MU 


Move Mode I/O Command 


LU 


Load Mode I/O Command 


H 


Halt 



*See Appendix D 



Figure 21. Mnemonic Operation Codes 
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Figure 22. No Operation; Word Mark 
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Figure 23. No Operation 



label for location 01950. ) Thus, the assembled instruc- 
tions will be NJ01950b, with word marks over N and J. 

Note: The processor will automatically substitute a 
twelve-position nop machine instruction for any state- 
ment in the source program containing an invalid 
operation code. This is done to permit patching of the 
object deck. 



DA — Define Area 

The functions of the da statement are to reserve and 
define areas of core storage, such as input, output, 
or work areas. Fields within each area can be defined 
by the use of successive statements (called da sub- 
entries ) , with a blank operation code ( columns 16-20 ) . 
The label associated with the da statement refers to 
the high-order address of the reserved area. The label 
associated with a subentry within the area refers to 
its low-order address. 

DA Statement 

The area or areas to be reserved must be defined in 
the operand field of the da statement. The operand 
field of the da statement contains a parameter of the 
form B x L, where B (blocking factor) is the number 
of identical areas to be defined, and L is the length of 
each area: B x L = Defined Area. In Figure 24, B = 1 
and L = 80. Thus, 1 x 80 = 80 positions of core storage. 



Operation 
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Figure 24. One Area of 80 Positions Defined in a da Statement 



Declarative Operation Codes 

Declarative operation codes are used in Autocoder 
statements that are translated by the processor into 
data areas, data constants, and address constants used 
by the object program, and to define and identify 
labels. 

Declarative operations enable the programmer to 
refer to work areas and constants by their descriptive 
names ( labels ) without regard to their actual locations 
in core storage. For example, if the programmer wants 
to reserve 20 consecutive core-storage positions for 
accumulating a final sales total, a declarative operation 
enables him to reserve the area and refer to it by a 
label, without concern for the actual address of the 
field. In this case the label may be total or accum, 
or some other label descriptive or meaningful to the 
programmer. 

There are seven declarative operation codes. Their 
use, function and formats are discussed in the following 
order. 

OPERATION CODE STATEMENT FUNCTION 

DA Define Area 

DAV Define Area in COMMON 

RSV Reserve Assignment in COMMON 

DCW Define Constant with Word Mark 

DC Define Constant ( no word mark ) 

DS Define Symbol 

EQU Equate 



Note that in Figure 25, B = 24 and L = 80. Thus, 
24 x 80 = 1,920 positions of core storage to be re- 
served. The label refers to the high-order position of 
the total area defined. (The number of positions re- 
served will be increased if certain additional elements 
are specified in the operand field. These elements are 
explained in succeeding paragraphs.) 
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Figure 25. Defining 24 Identical Areas of 80 Positions Each 

DA Subentries 

The programmer frequently wants to process fields 
and subfields within a single area, or successive identi- 
cal areas. These fields must be defined in the da 
subentry statements immediately following the da 
statement. The operation fields for these subsequent 
entries must be blank. If a label is used, it refers to 
the low-order position of the field. 

The operand of each subentry must specify the 
relative location of the field within the defined area. 
The first location ( high-order position ) of each defined 
area is considered location 1. The high-order and low- 
order positions of the subentry field (relative to loca- 
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tion 1) are placed in the operand field. These two 
numbers must be separated by a comma. The proc- 
essor places a word mark over the high-order position 
of each field thus defined. 

If no word mark is desired, it is necessary to place 
only the relative low-order position in the operand 
field. The label will refer to this low-order position, 
and no word mark will be assigned by the processor. 
A word mark can, however, be associated with a 
single-position field by writing the relative location 
of the position twice, and separating the two numbers 
by a comma. This is illustrated in Figure 26. 
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Figure 27. Indexing Fields in a da Statement 



DA Statement Parameters 

Five optional parameters can be specified in the 
operand field subsequent to the B x L parameter in 
a da statement. Any or all of these parameters can 
be used in any order; however, the B x L parameter 
must be first. These parameters are explained under 
the following headings: 

Field Indexing 

Group Mark with Word Mark 

Record Mark 

Relative to Zero Addressing 

"No-Clear" Option 

FIELD INDEXING 

The labels of all da subentries will be automatically 
indexed by the index register noted in the da state- 
ment (Figure 27). However, the label of the da 
statement can be indexed only when used as an 
operand. That is, the label of the da statement must 
have the index register notation affixed to it, each 
time it is referenced, if index adjustment is desired. 

In Figure 27, the labels defined in the da subentries 
will be automatically indexed by the contents of index 
register 2. However, if one of the labels used as a 
symbol in the operand field of an instruction is fol- 
lowed by an indexing notation, this indexing overrides 
the indexing specified in the da statement. 

Overriding indexing, as explained above, is effective 
only for the instruction in which it appears. In sub- 
sequent instructions, the index indication of the da 



statement will be effective. In Figure 28 gross is 
indexed by the contents of index register 3, regardless 
of the index register indicated in the da statement 
in which it was defined. 
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Figure 28. Overriding the da Statement Index of a Field 



The programmer can negate the effect of indexing 
in a field by putting an XO ( X-zero ) in the operand of 
each instruction in which indexing is not wanted. Here, 
again, the original index indication is effective in 
subsequent instructions ( Figure 29 ) . 
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Figure 29. Negating the da Statement Index of a Field 



GROUP MARK WITH WORD MARK 

v 

If a group mark with word mark (^) is desired after 
the total defined area, the character 4 s ( 12-7-8 punch ) , 
preceded by a comma; or the letter G, precede;! by 
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Figure 26. Areas and Fields Defined in a da Statement 



24 



a comma, must be used as a parameter of the da 
statement ( Figure 30 ) . 
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Figure 30. Group Mark with Word Mark after Total Area 



RECORD MARK 

If a record mark ( =f= ) is desired after each area, when 
multiple areas are defined, the character 4= (0-2-8 
punch), preceded by a comma; or the letter R, pre- 
ceded by a comma, must be used as a parameter of 
the da statement ( Figure 31 ) . 
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Figure 31. Indicating Record Marks in a da Statement 

The da statement in Figure 31 will cause the proces- 
sor to generate a record mark after each area. This 
means that there will be a total of 1,945 positions of 
core storage reserved: (24 x 80) +24 record marks + 
group mark with word mark = 1,945 positions of core 
storage. When indexing this statement in a loop to 
process each area consecutively, 81 positions should be 
allowed to include the record mark with each area. 

RELATIVE TO ZERO ADDRESSING 

By writing the character zero, preceded by a comma 
( ,0 ) , as a parameter of the da statement, the processor 
will assign addresses to the labels of fields as though 
the high-order position of the defined area were core- 
storage position zero. However, the label of the da 
statement will still be assigned the address of the high- 
order position of the area actually reserved by the 
processor (Figure 32). 
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Figure 32. Relative to Zero Addressing 

Note: If relative to zero addressing is used, the fields 
will be assigned a no relocation indicator. Field index- 
ing is required. 

"no-clear" option 

The area reserved by the da statement is normally 
cleared to blanks before setting word marks and/or 



record marks. By writing the character N preceded 
by a comma ( ,N ) as a parameter of the da statement, 
the area reserved by the da statement will not be 
cleared to blanks when the program containing the 
area is loaded into core storage from the mjb. (See 
Figure 33 for an example. ) This option is not effective 
when the program is loaded from the sof. 
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Figure 33. Negating the Clearing of an Area to Blanks 

Sample Problem 

In this problem, data is to be read from magnetic tape 
into an area of storage, where it is to be processed. 
This area, labeled readarea, is indexed by index 
register 2 and will have a final group mark with word 
mark. This is a payroll operation, and each record 
refers to a different employee. The records are writ- 
ten on tape in blocks of 24. Each record is 80 characters 
long, and has the following format: 



LABEL 


POSITIONS 


DATA 


MANNO 


4-8 


Man Number 


NAME 


11-30 


Employee name 


DATE 


32-37 


Date 


GROSS 


45-64 


Gross wages 


WTAX 


66-71 


Withholding tax 


FICA 


74-79 


FICA deductions 




35 


Month 




22-28 


Employee first name 



The labels and their associated fields can be listed 
in any order. (Labels are not assigned to month and 
employee first name because they will not be needed 
in this problem.) One way of coding the required 
elements is illustrated in Figure 27. 

The programmer can now, in his source program, 
write an iocs macro-instruction to cause data to be 
read from tape into a storage area labeled readarea. 
This causes a block of 24 eighty-character data records 
to be placed in the 1,920 reserved positions of core 
storage. This data can now be referred to by the 
labels date, name, fica, etc., in the first of the 24 
records that occupy readarea. The iocs controls the in- 
dexing used to reference and process the data in the 
subsequent records, 2 through 24. 

After all the processing required in the first record 
is complete, index register 2 is incremented by 80. 
Because all. labels defined by this da statement are 
increased by the contents of index register 2, the 
routine now processes the second data record of the 
block read into core storage. This process is repeated 
until all the records have been processed. 

Review 

Figure 34 summarizes the main points covered in the 
preceding discussion of the da statement parameters, 
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and shows the various entries which can be written 
in the da statement. The B x L entry must be first; 
the other entries can be written in any order. 
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Figure 34. Possible Elements in a da Statement 

The following chart summarizes the main points of 
the processor's treatment of areas and subentries. Al- 
though the index register indication appears in the da 
statement, only the subentries are indexed. The da 
statement label can be indexed in any instruction in 
which it appears. 

WORD MARK LABEL 

SET WHERE SET REFERENCED 

AREA(s) NO HIGH-ORDER 

FIELD 

FORM(X,Y) YES HIGH-ORDER LOW-ORDER 
FORM(Y) NO LOW-ORDER 

SINGLE 

POSITION 

FIELD 

FORM(X,X) YES LOCATION LOCATION 

FORM(X) NO LOCATION 



DAV — Define Area in COMMON 

The dav statement is used to define an area in common 
in a manner similar to the da statement. However, 
labels of fields are automatically assigned downward 
relocation indicators (except when relative to zero 
addressed, resulting in a no relocation indicator). 

The format of the two statements is identical, except 
for the operation code. For a discussion of conventions 
for specifying a dav statement, its subentries, and the 
five optional parameters available in the dav operand 
field, see "da — Define Area." 

Before proceeding to examples illustrating the use 
of the dav statement, the following discussion on 
common is included for those users unfamiliar with 
its requirements and function. 

The Autocoder processor makes the following as- 
sumptions when assembling the object deck: 

1. The Linkage Loader will relocate downward all 
addresses referring to common. The downward reloca- 
tion factor applied will be such that the value con- 
tained at the system symbol /ams/ will be the topmost 
limit of common; or, if furnished in the program, the 
base2 statement will specify the topmost limit. 

2. The topmost address in common will be assigned 
the value 99999 by the processor, and go downward. 

3. The processor will not assemble data or instruc- 
tions to be loaded into common. For example, a dc 
or a dcw cannot be used to load data into common. 



Data can be placed into common only through the 
execution of the object program. 

4. The label common is an indelible entry in the 
processor's symbol table. It has the address value of 
99999, and has a downward relocation indicator at- 
tached. If the user defines common as the label of a 
source statement, it will receive an "M" (Multiple 
Definition) flag. 

Two steps must be taken by the programmer to 
make use of common in his subprogram. The steps are 
discussed under the following subheadings: 

Assignment of Data Areas in common 

Use of Labels Referencing common 

Assignment of Data Areas in COMMON 

The programmer must define the assignment of data 
fields and areas within the common data areas. Since 
common starts at 99999 and goes downward, the pro- 
grammer determines the total number of positions he 
requires and assigns space upward for each data 
field and area. The highest position he can use is 
99998. (This technique is illustrated in Figures 61 
and 62. ) 

If a program contains two or more subprograms, 
each of which contains references to the same data 
fields in common, these subprograms must assign core 
storage in common in the same way (or in a way 
compatible with each subprogram's needs). That is, 
the same data field must be assigned the same relative 
address in each of the subprograms. 

One way of assuring compatible common area 
referencing is to include identical common area source 
statements in each of the subprograms involved (i.e., 
identical dav, equ, or rsv statements ) . 

Labels referencing the common Data Area can be 
defined in any of the following ways: 

1. The equ statement. For example, for the state- 
ment a equ common — 10, the label (A) will be as- 
signed the value 99989 (that is, 99999-10). Subse- 
quent labels in the source program can be equated to 
this label (A). Under these conditions, this label and 
subsequent labels will be assigned downward reloca- 
tion indicators. 

2. The dav statement and associated dav subentry 
statements. (Normally dav statements follow an org 
statement that places the dav area within common.) 
Labels used in the dav and subentry statements will be 
assigned downward relocation indicators. 

3. The rsv statement followed by an equ statement 
for an actual address value in common. For example: 



LABELB 



RSV 

EQU 



LABELB 

99985 



26 



If a subsequent label is to be equated to labelb, 
the rsv statement must be used, with the subsequent 
label as the operand. For example: 



LABELC 



RSV 
EQU 



LABELC 
LABELB 



Use of Labels Referencing COMMON 

Once the programmer has defined labels referencing 
common, he can use them as if they were labels as- 
signed to fields and areas within the usual boundaries 
of the subprogram. Thus, data can be manipulated and 
operated upon, and iocs can be employed to read data 
into and out of areas contained in common. 

RESTRICTION 

The processor will not assemble data or instructions to 
be loaded into common. Data can be placed into 
common only through the execution of the object pro- 
gram. Hence, Autocoder declarative statements, such 
as the dc and dcw statements, cannot be used to enter 
data into common. 

The effect of the dav statement is different in several 
respects from the da statement, since the defined area 
is not located within the body of the subprogram, but 
within the common data area. Hence the user of the 
dav statement must note the following: 

1. The programmer must specify the exact point 
within the common data area where the defined area 
will start. This can be done by means of an org state- 
ment, the technique of which is illustrated in Figure 
61. (The org statement is explained in the next section, 
under the subheading "org — Origin." ) 

2. The defined area in common can be used by 
other subprograms; the "No-Clear" option enables the 
programmer to retain the desired contents of common. 



3. The dav subentry statements can be used to set 
word marks in their respective fields. 

4. The dav statement can be used to clear the area 
it will occupy in common, and to set record marks 
and a group mark with word mark. 

The coding examples in Figure 61 illustrate the as- 
signment of labels within common. The relative ad- 
dresses assigned are shown as comments. All labels are 
assigned downward relocation indicators. 

The second part of Figure 35 illustrates all the ele- 
ments that can appear in the dav statement. 

Note: A group mark with word mark will be placed 
at the topmost usable position in common (99998). 

An alternative way of assigning the same labels is 
illustrated in Figure 36. In this example, the fields are 
not cleared and no word marks are set automatically. 
Word marks are set during program execution by 
means of imperative statements. 



RSV — Reserve Assignment in COMMON 

The rsv statement is used to direct the processor to 
affix a downward relocation indicator to a label that 
references a field in common. The label is used as the 
operand of the rsv statement (Figure 37). The rsv 
statement must precede the use of the label as an oper- 
and in the source program. 

In Figure 37, the operand alpha will be assigned 
a downward relocation indicator each time it appears 
in a subsequent instruction. 



DCW — Define Constant with Word Mark 

A dcw statement is used to enter a numeric, alpha- 
meric, blank, or address constant into a core-storage 
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• Figure 35. Label Assignment in common and dav Statement Elements 
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• Figure 36. Label Assignment in common 



Line 
3 5 


Label 

6 


IS 


Operation 

16 20 


21 25 


30 


35 


40 ( 


0, 1, 


1 
1 , , , 


rt.SV. . 


4.LP.H-A- ■ ■ 








2 


1 

: i 








, , , , 


..... \ 



Figure 37. The rsv Statement 

location assigned by the processor. The processor 
places a word mark over the high-order position of the 
defined constant. 

The label of the dcw statement makes reference to 
the address of the low-order position of the constant. 
The high-order position will be referenced if the label 
is indented one column in the label field; that is, if it 
begins in column 7. In all cases the constant being 
defined must be left-justified in the operand field. 

Five types of constants can be defined by means of 
the dcw statement. They are discussed under the fol- 
lowing headings: 

Numeric Constants 

Alphameric Constants 

Blank Constants 

Address Constants 

Signed Address Constants 

Numeric Constants 

A numeric constant, defined in a dcw statement by the 
numeric characters in the operand field, can be pre- 
ceded by a plus or minus sign, or it can be unsigned. 
A plus sign causes A and B bits to be placed over the 
units digit. A minus sign causes a B bit to be placed 
over the units digit. Unsigned constants will be un- 
signed in storage ( Figure 38 ) . 

The first blank column encountered in the operand 
field terminates a numeric constant. A numeric constant 
cannot be more than 51 characters long if it is signed; 
52 if unsigned. 
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Figure 38. Numeric Constants Defined in dcw Statements 



Alphameric Constants 

An alphameric constant must be preceded and fol- 
lowed by the @ character (4-8 punch). Blanks and 
special characters, including the @ character itself, 
may be used in the body of the constant. The proc- 
essor, in scanning the operand field, will consider every- 
thing to the left of the rightmost @ character a part 
of the constant being defined. For this reason, the @ 
character is not permissible in comments on the same 
line. An alphameric constant can contain up to 50 
characters, excluding the initial and terminal @ charac- 
ters. A comma preceding a G (,G) following the trail- 
ing @ character causes the processor to put a group 
mark with word mark in storage following the last 
character in the constant. ( The label refers to the low- 
order position of the field, not the group mark posi- 
tion. ) 

In Figure 39, the group mark with word mark was 
used with a dcw statement to be written by the console 
printer. The label of the message was indented to ref- 
erence the high-order position. A group mark with 
word mark is required to halt message typing on the 
console printer. 

Note: The word separator character (0-5-8 punch) 
must never be coded as the first character of a dcw 
alphameric constant. 
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Figure 39. Alphameric Constants Defined in dcw Statements 
28 



Blank Constants 

A field of blanks can be reserved by placing a # char- 
acter (3-8 punch) in column 21, followed by a number 
indicating how many consecutive blank core-storage 
positions are to be defined (Figure 40). A word mark 
is set in the high-order position of this field. 

Note: The number of successive blank constants 
that can be reserved by a dcw statement is limited to 
500 positions of core storage. If this limit is exceeded, 
the processor will reserve only the maximum (500 
positions), and attach an "F" flag to the statement on 
the assembly listing. 



a storage location. In Figure 42, manno (actual address 
00500) has been address adjusted by +12. Thus, the 
location labeled pica will contain the address constant 
00512. 
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Figure 42. Address Constant with Address Adjustment Defined 
in dcw Statement 




Figure 40. Field of 14 Blanks Defined in a new Statement 



Address Constants 

A dcw statement can be used to define an address con- 
stant. The constant is the address of the field whose 
label is written in the operand. For example (Figure 
41), assume that the label manno is used in the sym- 
bolic program, and that it was assigned the address 
00500 by the processor. The programmer can refer to 
the address of manno by using the symbolic label of 
the dcw statement. 
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Figure 41. Address Constant 



The five-character data field labeled serial ( Figure 
41) will contain the address of the label manno 
(00500). The Linkage Loader will recognize address 
constants and adjust them by the proper relocation 
factor. Thus, serial will contain the relocated address 
of MANNO. 

If an address constant is address adjusted in a dcw 
statement, the constant is adjusted before it is assigned 



Address constants defined in a dcw statement can 
be indexed. The zone bit(s) indicating the specified 
index register becomes part of the constant. 

Note 1: All address constants receive the same relo- 
cation indicators that were assigned to the symbol 
specified in the operand field. 

Note 2: An address constant of a linkage or system 
symbol can be specified, and the desired address will 
be automatically supplied by the Linkage Loader. 
However, this form of address constant cannot be 
address adjusted or indexed. 

Signed Address Constants 

An address constant defined in a dcw statement can be 
signed. A and B bits will be generated by the processor 
over the units position, if the plus ( + ) sign was placed 
before the operand. The units position will contain a 
B bit if the minus ( — ) sign was used ( Figure 43 ) . 
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Figure 43. Signed Address Constants Defined in new Statement 



Implied DCW Operation Codes 

If a number of constants are to be defined in succession, 
only the first statement requires the mnemonic dcw, 
in the operation field ( Figure 44 ) . 
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Figure 44. Successive dcw Statements with Blank Operation Columns 
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DC — Define Constant (no word mark) 

The function performed by the dc statement, and the 
permissible forms of the constants, are identical to 
those described for the dcw statement. The only differ- 
ence is that the word mark is absent when the constant 
is assigned to core storage ( Figure 45 ) . 
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Figure 45. Successive dc Statements with Blank Operation 
Columns 



Note: The restriction on the use of an initial word 
separator character in the dcw statement defining an 
alphameric constant does not apply to the dc statement. 



DS — Define Symbol 

The ds statement is used to label and define an area 
within the subprogram. No information is entered into 
the area, no word mark is assigned by the processor, 
and the area is not cleared prior to reservation. The 
programmer specifies the size of the area, and desig- 
nates the symbolic label by which it will be referenced. 
The number of desired consecutive positions of core 
storage is written in the operand field ( Figure 46 ) . The 
label refers to the low-order position of the area. 
However, if the label is indented one place, that is, 
if it begins in column 7, the label will refer to the high- 
order position. A label is not mandatory. 
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resentation of the location to be "equated" is specified 
in the operand field. 

An equ statement can be used to assign a symbolic 
label to each of the following: 

Actual or symbolic address 

Adjusted or modified address 

Index register 

Asterisk address 

Actual or Symbolic Address 

The symbol to be defined is specified in the label field. 
The operand field can contain an actual or symbolic 
address. If a symbolic address is specified in the op- 
erand field, it must have appeared as a label prior to 
this point in the subprogram. If this condition is not 
met, the label will not be defined. 

SYMBOLIC ADDRESS 

The equ statement in Figure 47 will cause the processor 
to assign the same address to the label individual 
that is assigned to the symbol manno. Thus, individual 
has been equated to manno — both labels refer to the 
same core-storage location and are assigned the same 
relocation indicator by the processor. 
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Figure 46. Defining Twelve-Position and Five-Position Areas in 
ds Statements 



Figure 47. Equating a Symbolic Address 



ACTUAL ADDRESS 

The equ statement in Figure 48 will cause the processor 
to assign the label acctno to machine location 25000. 

Note: Labels equated to actual addresses will be 
treated as absolute values and given a no relocation 
indicator. 



Figure 46 illustrates the form of the ds statement. 
The first entry, labeled dozen, defines an area twelve 
positions long. The second entry, labeled five, defines 
an area five positions in length. 
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Figure 48. Equating an Actual Address 



EQU — Equate 

The equ statement is used to define either a second 
symbol to reference a specific location, or a symbol 
for a location not previously labeled. The symbol to 
be defined is specified in the label field, and the rep- 



Adjusted or Modified Address 

The operand of an equ statement can be address ad- 
justed or indexed. The same relocation indicators 
assigned to the address adjusted and/or indexed op- 
erand will be given to the defined label. 
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EQUATING TO AN ADDRESS ADJUSTED OPERAND 

In Figure 49, the processor assigns the label whtax 
to a location ten storage positions lower than the loca- 
tion labeled fica. That is, if fica is assigned location 
00890, whtax will be equated to fica- 10, or 00880. 
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Figure 49. Equating with Address Adjustment 



EQUATING TO AN INDEXED OPERAND 

A label can be equated to an indexed operand. In 
Figure 50, custno is equated to jor indexed by index 
register 3, not job alone. That is, custno will be as- 
signed the address of job, with A and B bits over the 
tens position ( the tag for index register 3 ) . 

An indexed operand can also be address adjusted. 
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Figure 50. Indexing in an equ Statement 



EQUATING TO TWO LABELS 

A label can be equated to the algebraic sum or dif- 
ference of the values represented by two symbolic 
labels, in the form c equ a±b ( + or — ), where A and 
B are previously defined labels (Figure 51). (The 
treatment of the form c equ a+b, where B is the label 
for an index register, is explained under the sub- 
heading "Index Register.") 
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Figure 51. Equating a Label to Two Symbolic Labels 



relocation indicator, C will be assigned a no reloca- 
tion indicator. 

Index Register 

The label of an equ statement can be defined as an 
alternative symbolic name for an index register. The 
processor's predefined label for the index register to be 
equated (X1-X15) is written in the operand field. 
Figure 52 illustrates this technique. 
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Figure 52. Labeling an Index Register with an equ Statement 



In Figure 52, the label loop will be assigned by the 
processor to index register 9. Thus, index register 9 
can be referred to as loop, instead of X9. This use of 
a symbolic index register is illustrated in Figure 53. 
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Figure 53. Use of a Symbolic Index Register 



Note 1: Symbolic index registers must be equated 
before they can be used in an instruction. 

Note 2: A label can be equated to an actual or 
symbolic operand indexed by a symbolic index register, 
in the form c equ a + b. The label B represents the in- 
dex register. The label C will be assigned the same 
relocation indicator assigned to A. 

Asterisk 

A label can be equated to an asterisk address, with 
or without address adjustment and/or indexing (Fig- 
ures 54 and 55 ) . 



In Figure 51, if whtax references core-storage loca- 
tion 08000 and second references location 01500, the 
label next will be assigned the value equal to the sum 
of both; that is, 09500. If a minus sign is used instead 
of a plus sign, the label next will be assigned a value 
equal to their difference, that is, 06500. 

Note 1: No further adjustments (or indexing) are 
allowed. 

Note 2: If either A or B is assigned a no relocation 
indicator, C will be assigned the relocation indicator 
of the other label. If neither A nor B is assigned a no 
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Figure 54. Equating an Asterisk Operand 



In Figure 54, the label fielda refers to the location 
next available in the program. If the next available 
location in the program is 00698, fielda is equated to 
00698. 
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Figure 55 illustrates the use of the equ statement 
with an address adjusted asterisk operand. If the aster- 
isk refers to location 00698, the label fielda is equated 
to 00710. 
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Figure 55. Asterisk Operand with Address Adjustment 



linkage Loader Operation Codes 

The output of an Autocoder assembly is in the inter- 
mediate form of a relocatable object deck. It is during 
the execution of the Linkage Loader that the object 
deck is converted into absolute form. The absolute 
object program consists of relocated subprograms with 
linkages to each other, as well as to the Resident 
Monitor. In order to accomplish this conversion, the 
Linkage Loader requires certain specific information, 
presented according to the conventions of the System 
Monitor. 

The Autocoder language provides eight statements 
by which the programmer can communicate the sub- 
program's requirements to the Linkage Loader. Al- 
though these statements can be added to the object 
deck of a subprogram after its assembly, their inclusion 
in the form of an Autocoder statement affords the 
following benefits: 

1. Automatic conversion of the statement into the 
format required by the Linkage Loader 

2. Error diagnosis of the statement as it relates to the 
subprogram being assembled 

3. Automatic sequencing ( card columns 73-75 ) and 
identification (card columns 76-80) of the statement 
within the relocatable object deck 

The Linkage Loader statements permitted in a sub- 
program assembly contain the following operation 
codes: 



OPERATION CODE 


STATEMENT FUNCTION 


TITLE 


Title of Subprogram 


BASE1 


Base Address 


BASE2 


Base Address ( COMMON Data 




Area) 


CALL 


Subprogram Call 


DCWF 


Subprogram Address Constant 


DCWS 


Subprogram Branch Instruction 


DEFIN 


Definition 


PRTCT 


Protect 



In the following descriptions of these statements, 
only permissible formats and a brief description of their 
functions are given. The reader is directed to the pub- 
lication, System Monitor, for details concerning the 
functions performed by these Linkage Loader control 
operations. 



TITLE — Title 

The title statement is used to establish an identify- 
ing name for a subprogram, to indicate the size of 
the common data area the subprogram will use, and to 
state the lowest origin point in the subprogram. 

Entries 

The name of the subprogram must be a conventional 
label (1-10 alphameric characters in length), and ap- 
pears as the first entry in the operand field. This name 
can be used in dcws, dcwf, basei, base2, p'RTCt, and 
call statements. (These statements are individually 
explained in this publication. ) 

Note: All names of IBM-provided modules in the 
Operating System start with "ib'\ The user should be 
aware of this standard to avoid duplicating the name 
of a module when naming a relocatable subprogram. 

The specified size of the common data area required 
is written as the second operand entry in the form of 
an integer, one to five positions in length, and is 
optional. If it is omitted, the processor will leave the 
corresponding field in the object program's title card 
blank, and the Linkage Loader can subsequently give 
no warning if the program and common data area 
should overlap. 

The lowest origin point is the third operand entry 
and can be omitted. If it is omitted, the processor will 
place into the object program's title card the lowest 
address assigned during the assembly. If the third 
entry is included, the automatic computation of the 
processor is negated, and the value declared by the 
entry is passed on to the Linkage Loader through the 
title card. This entry can be an actual value or a label 
within the assembly. 

Although the third entry is normally omitted, it can 
be useful under the following conditions: 

1. When a program being assembled contains one 
or more spend statements and, 

2. When the low origin points of the subprograms 
are different and it is necessary that these differences 
be indicated. 

Format Considerations 

The entries are written in the operand field, and sep- 
arated by commas. If the second entry is omitted and 
a third entry is used, the third entry must be sep- 
arated from the first entry by two commas. If both the 
second and third entries are omitted, only the name 
is required, with no trailing commas (Figure 56). 

Note 1: The title card should be the first source 
statement in a subprogram, with the exception of any 
of the Assembly Control statements explained later. 

Note 2: The title card is the first card in the object 
deck, with the parameters rearranged to meet the re- 
quirements of the Linkage Loader. 
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Figure 56. Permissible Forms of the title Statement 

Note 3: The contents of the system symbol /dat/, 
the date currently stored in the Resident Monitor, will 
be placed in the date field (columns 6-10) of the re- 
arranged title card in the object deck. This date will 
also appear in the heading line of the assembly listing. 



BASE 7 — Base Address 

The basei statement can be used to control the Link- 
age Loader's relocation factor. The following operands 
are permissible in a basei statement: 

Actual 

Symbolic 

Asterisk plus X00 ( * + X00 ) 

Actual 

The actual core-storage location is written in the op- 
erand field ( Figure 57) . 
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Figure 57. Use of an Actual Address in a basei Statement 

Symbolic 

A symbolic address can be a subprogram name or a 
linkage symbol defined in a subprogram that is 
processed by the Linkage Loader prior to the sub- 
program in which the basei statement appears. This 
symbolic address is defined by means of the title or 
defin statements ( see below ) . 

In Figure 58, the operand programs is the name of a 
subprogram that is defined by a title statement. 
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Figure 58. Symbolic Address in a basei Statement 

Note: A blank operand sets the relocation factor to 
base zero. 

Asterisk Plus X00 (* +X00) 

If an * + X00 is the operand of a basei statement, the 
relocation factor will be incremented so that program 



loading will continue at the next even-hundred loca- 
tion. For example, if the asterisk has the relocated 
value of 18279 the relocation factor will be adjusted 
to 18300. If the value of the asterisk is already an even- 
hundred address, that value will remain the relocation 
factor. 

Note: The * + X00 form of the basei statement must 
be used in conjunction with an org statement contain- 
ing * + X00 in the operand field. (See "org — Origin," 
under "Control Operation Codes.") 



BASE2 — Base Address (COMMON Data Area) 

The bases card is used to set the upper limit of the 
common data area. The operand of the base2 card, 
which can be either a linkage symbol or an actual 
address, is as described under the basei statement. The 
form * + X00 is not valid in a base2 statement. 



CALL — Subprogram Call 

The call statement provides the Linkage Loader with 
the name of a subprogram that is to be loaded from 
the System Library file or from the go file. The oper- 
and of the call card is the name of the subprogram 
to be processed by the Linkage Loader (Figure 59). 
When the call card produced by the processor is 
loaded with the object deck, the operand of the call 
statement is passed directly to the Linkage Loader. 

In Figure 59, the linkage symbol iomodule must 
have been defined by a title statement in the subpro- 
gram being called. 
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Figure 59. The call Statement 

DCWF — Subprogram Address Constant 

The dcwf statement is used to specify an address 
constant (similar to the dcw unsigned address con- 
stant) and to create an imbedded call for the named 
subprogram. The operand of the dcwf statement must 
be the name of the requested subprogram as specified 
in its title card if the operand has not yet been located 
and processed (forward reference). Otherwise, it may 
be any linkage symbol. 

The label of a dcwf always refers to the high-order 
position of the address constant. This label must not 
be indented. 

The dcwf statement instructs the Linkage Loader 
to perform the following functions: 
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1. Include the named subprogram with the pro- 
gram that contains the dcwf statement. 

2. Provide an address constant of the relocated 
origin point of the named subprogram. This address 
constant is placed into the position in which the 
dcwf statement appears in the source program (Fig- 
ure 60). 

This operation code assumes a higher mnemonic 
value if thought of as representing a dcw— Five-position 
address. 

In Figure 60, assuming that the subprogram third 
was relocated to start at location 10400, the address 

V 

constant at object time will be 10400. 
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Figure 60. Use of the dcwf Statement 

DCWS — Subprogram Branch Instruction 

The dcws statement has the same format as the dcwf 
statement (Figure 61); however, a seven-position un- 
conditional branch is constructed instead of a five- 
position address constant. This statement causes the 
following: 

1. The named subprogram will be located and 
processed by the Linkage Loader. 

2. A seven-position unconditional branch instruc- 
tion (branching to the relocated origin point of the 
named subprogram) will be constructed by the Link- 
age Loader, and placed into the position in the sub- 
program in which the dcws appears. 

This operation code assumes a higher mnemonic 
value if thought of as representing a dcw— Seven- 
position branch. 

The dcws statement in Figure 61 results in an un- 
conditional branch instruction being placed into that 
position in the subprogram in which the dcws appears. 
If the subprogram third is relocated to the origin point 
14000, the resulting branch instruction is J14000b. 
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Figure 61. Use of the dcws Statement 

DEFIN — Definition 

The defin statement is used to define a linkage symbol. 
This linkage symbol can represent an entry point or 
data field within the subprogram being assembled. This 
symbol can be referenced by other subprograms, which 



may be assembled separately. The defin statement can 
be used to establish linkage symbols of both formats: 
labe/ or the conventional label type. 

Figure 62 illustrates the format and use of the Auto- 
coder defin statement together with the object card 
produced. Consider the linkage symbol tabl/ to be an 
address appearing in one or more subprograms to 
be loaded with the subprogram containing the defin 
statement. When progi is loaded, the operand of the 
defin card is relocated by the progi relocation factor, 
producing an absolute address for each usage of 
tabl/. The Linkage Loader will replace every usage 
of tabl/ with the relocated defin value. For example, 
if in another subprogram the instruction 

MLCA SAM#5,TABL/ 

appears, the object card produced by the Auto- 
coder processor contains D00700TABL/T (assuming 
00700 is the value of sam). When the subprogram 
containing this instruction is loaded with progi, the 
Linkage Loader resolves both the A and B operands. 
The A operand is incremented by the upward reloca- 
tion factor. The B operand, tabl/, is replaced by the 
relocated defin value. If 14000 is the relocation factor 
for the subprogram containing tabl/ as the label of 
the defin statement, and 15600 is the relocation factor 
for the program containing tabl/ as an operand, the 
instruction in storage is D 16300 15J?0T. 

Note: The defin statement is the only one in which 
the five-position linkage symbol labe/ can appear in 
the label field. 
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Figure 62. The defin Statement 

PRTCT — Protect 

The PRTCT statement is used to set a limit for erasure 
of linkage symbols from the Linkage Loader's symbol 
table. The Linkage Loader will retain in its symbol 
table all linkage symbols equal to or higher than the 
address value specified by the operand of the prtct 
statement. 

The operand of a prtct statement can be either a 
linkage symbol or an actual value ( Figure 63 ) . Neither 
indexing nor address adjustment is permitted. 
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Figure 63. The prtct Statement 

Control Operation Codes 

Control operation codes are used in Autocoder state- 
ments that give directions to the processor in perform- 
ing specified operations at assembly time. There are 
two types of control statements, discussed under the 
following subheadings: 

Assembly Control Statements 

Subprogram Control Statements 

Assembly Control Statements 

Assembly control statements are related to the assem- 
bly listing, object program cards, and the cross 
reference listing. They do not affect the subprogram 
being assembled. The assembly control operation 
codes are: 



OPERATION CODE 


STATEMENT FUNCTION 


HEADR 
RESEQ 
EJECT 
PST 


Header Line 

Resequence Object Cards 
Eject Listing Page 
Print Symbol Table 



HEADR — Header Line 

The headr statement (Figure 64) is used to direct the 
processor to perform the following functions: 

1. Cause printing of specified information in the 
header line on each page of the assembly listing. The 
header line contains the contents of the headr card, 
columns 21-72. If the header card is absent from the 
source deck the processor will move blanks into the 
printing positions. 

2. Cause punching of the identification in columns 
76-80 of the headr card into the same columns of each 
output card in the object deck. This identification will 
also appear in the header line of the listing page. 

3. Cause the card sequence count to be set at 001 
in the object deck. 

4. Cause printing to begin on a new page during 
listing. 

The information printed in the header line can be 
written anywhere in the operand field, columns 21-72, 
of the headr statement. 

The identification written in the identification field, 
columns 76-80, can consist of special, as well as alpha- 
meric, characters. This identification can be changed by 
a reseq statement. ( See "reseq — Resequence." ) 

If another headr statement appears elsewhere in the 
source program, it causes printing to begin on a new 



page during listing; the new information will appear 
in the heading line and all subsequent heading lines, 
and in the object deck. The card sequence count of 
the subsequent program will start at 001. (See Fig- 
ure 64. ) 

Note: The headr statement is permitted between 
the spend and title statements, allowing the next sub- 
program in the assembly to be listed under its own 
page heading, and the object deck to contain the new 
information. 

RESEQ — Resequence 

The reseq statement allows the programmer to sep- 
arate his object deck into logical groups or blocks by 
controlling the sequence number and identification 
field of the object program cards produced by the 
processor (Figure 65). In this respect it is similar to 
the headr statement. 

The reseq control operation directs the processor to 
perform the following functions: 

1. Punch the new identification supplied by this 
statement, card columns 76-80, into columns 76-80 of 
subsequent object cards, and replace the identification 
in the header line. 

2. Set the card sequence count to 001 in the object 
deck. 

3. Direct printing to begin on a new page during 
listing. 

There are only two entries in a reseq statement: 
reseq in the operation code field, and the identification 
of columns 76-80 ( Figure 65 ) . 

Note 1: A reseq statement can appear between the 
spend and title statements. 

Note 2: The execute card, produced by the proc- 
essor from the end statement, contains the card se- 
quence number 999. This permits the insertion of 
sequenced patch cards. 

EJECT - Eject 

The eject statement causes printing to continue on a 
new page of the assembly listing, thereby separating 
routines or program sequences in the output listing. 
The statement consists of eject in the operation code 
field. The rest of the card remains blank ( Figure 66 ) . 
Note: An eject statement can be placed between 
a spend and title statement, if the next subprogram 
listing is to start at the top of a new page. 

PST — Print Symbol Table (Cross Reference Listing) 

The pst statement (Figure 67) is used to indicate to 
the processor that a cross reference listing is desired 
of all symbols used in the program. 

This cross reference listing appears after the assem- 
bly listing, and has the following features: 
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Columns 76-80 contain the identification of the subprogram that is printed in the 
heading line and punched into the object cards. 

Figure 64. The headr Statement 
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Columns 76-80 contain the identification of the subprogram that is printed in the 
heading line and punched into the object cards. 

Figure 65. The reseq Statement 
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Figure 66. The eject Statement 

1. It provides a list of every symbol used, in alpha- 
betic order, followed by the sequence number of the 
statement in which it was defined and the sequence 
number of every statement referencing it within the 
program. 

2. Undefined symbols and multiple definition of 
symbols are indicated. 

3. It distinguishes between index registers used as 
basic addresses and those used for indexing. 

4. It separates the literals according to program 
segment. (This literal separation is ineffective on pro- 
grams containing more than nine segments. ) 

Note 1: Since the cross reference listing does not 
require previous definition of the symbolic operands 
in org, ltorg and equ statements, the undefined indi- 
cations for these statements will appear in the cross 
reference listing only if the label is not subsequently 
defined. 

Note 2: The sequence numbers of equated index 
registers used as basic addresses are listed with the 
associated symbolic index registers. The sequence num- 
bers of symbolic index registers used as modifiers are 
listed with the associated actual index registers 
(i.e., X1-X15). 

The pst statement consists of the mnemonic opera- 
tion code and a blank operand field ( Figure 67 ) . 
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Subprogram Control Statements 

Subprogram control statements govern the form and 
sequence of subprograms, and supply the programmer 
with flexible control over the assembly process. The 
subprogram control operation codes are: 



OPERATION CODE 
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LTORG 
END 
SPEND 
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Figure 67. The pst Statement 
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ORG — Origin 

Sequential core-storage addresses are automatically 
assigned by the Autocoder processor to instructions, 
constants, and work areas. These assignments are ordi- 
narily made in the order in which the source program 
is read during the assembly process. The org state- 
ment, however, can be used to instruct the processor 
to break the sequential order of address assignments, 
and continue from another specified address. 

It should be noted that the org statement does not 
absolutely determine where the program will reside 
in core storage after relocation. The org statement 
controls address assignment during the assembly 
process, and the assembly listing indicates the relative 
placement of the various program elements within a 
subprogram. In this respect, the programmer retains 
the traditional freedom of controlling the relative loca- 
tions of blocks of coding and data within a subprogram. 

Unless a low origin is specified as the third param- 
eter of the source title card, the Autocoder processor 
determines the low origin and places it into the object 
title card. It is this low origin, whether specified or 
automatically generated, which, in conjunction with 
the basei value, determines the relocation factor to be 
applied to each upward-relocatable element in the 
object program. 

The relocation factor is the basei value minus the 
low origin value in the title card. The address occu- 
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Figure 68. Determining the Load Address 



pied by a unit of information in core storage is equal 
to the compiled address plus the relocation factor. See 
Figure 68 for representative examples. 

If the low origin in the object title card equals 
the true compiled low origin of the program ( the nor- 
mal case)., the program will load at the basei value. 

If the basei value equals the low origin, the program 
will load at the low origin, and the address within 
the program in core storage will equal the addresses in 
the assembly listing., 

When assembling a program containing spend cards, 
the programmer can force the title card to reflect the 
true low origin of each subprogram by specifying the 
respective low origin in each title statement. Other- 
wise, Autocoder will place the lowest origin point 
of the entire set of subprograms into each title card. 
( The use of identical title statement values is useful 
in designing program overlays.) 

If an org statement is not used, address assignment 
( by the Autocoder processor ) will automatically begin 
at 00000. 

The following types of operands are permissible in 
an org statement: 
Actual 
Symbolic 
Blank 
Asterisk 
Asterisk plus X00 ( * +X00) 



SYMBOLIC 

A symbolic operand is permissible only if the symbol 
has been previously defined. 

In Figure 70 the org statement will direct the proc- 
essor to continue address assignments from the address 
labeled phaseone. Address adjustment is permitted. 

Note: Neither linkage symbols nor system symbols 
are permitted in an org statement. 
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Figure 70. Symbolic Address in an org Statement 



BLANK 



An org statement with a blank operand instructs the 
processor to assign addresses to subsequent entries, 
beginning at the address that is one greater than the 
highest address thus far assigned by the processor. 



ASTERISK 



An asterisk operand can be address adjusted. The org 
statement in Figure 71 instructs the processor to assign 
storage locations consecutively, beginning 200 loca- 
tions above the current address. 



ACTUAL 



An actual address directs the processor to start assign- 
ing locations at the address specified. For example, in 
Figure 69 the address assignment will begin at 00500. 
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Figure 69. Actual Address in an org Statement 
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Figure 71. Asterisk Operand with Address Adjustment 
ASTERISK + X00 

The operand *+X00 instructs the processor to begin 
address assignment at the next available storage loca- 
tion whose address is a multiple of 100. For example, 
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in Figure 72, if the last address assigned was location 
10926, address assignment would continue at core- 
storage location 11000. 
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Figure 72. org Statement Advancing Address Assignment to 
Next Multiple of 100 



Note: Unless the org *+X00 card is preceded by a 
basei *+X00 card, the processor will assign a "W" flag 
to the org statement to warn the programmer that this 
subprogram must be loaded at an even-hundreds 
address. 

LABELING AN ORG STATEMENT 

The org statement permits the programmer to break 
the sequential assignment of a program temporarily, 
and to return subsequently to that point in the program 
sequence. This is done by labeling an org statement 
that breaks the sequence. When the programmer wants 
to return to the original point, an org statement with 
the label in the operand field can be used. The state- 
ments after the second org statement will be inter- 
preted by the processor as though the sequence had 
never been interrupted. 

The org statement, in Figure 73, shows how the 
programmer can direct the processor to save the ad- 
dress of the last storage allocated. The label addr is 
the symbolic address of the next available location 
before re-origin occurs. The processor will continue to 
assign addresses, beginning at the relative address of 
| common — 59. 
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• Figure 73. Saving the Address of Last Storage Allocated 

The programmer can insert another org statement 
later in the source program to direct the processor to 
begin assigning storage at addr. This statement is 
shown in Figure 74. 
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Figure 74. org Statement Referencing Last Storage Allocated 
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LTORG — Literal Origin 

ltorg statements are coded in the same way as org 
statements. Their function is to direct the processor 
to assign storage locations to previously-encountered 
literals. Storage assignment begins at the address writ- 
ten in the operand field of the ltorg statement. 

A ltorg statement can appear anywhere in the 
source program. If no ltorg statement appears ( Figure 
75 ) , the processor begins assigning addresses to literals 
when it encounters an end or spend statement. 

Figure 75 illustrates one way of directing the proces- 
sor to assign storage to all literals that have previously 
appeared within the subprogram segment in which the 
ltorg statement appears. 

Note: Since the ltorg statement signals the proces- 
sor to assign storage to previously-defined literals, the 
programmer who wishes to use similar literals must 
re-create them. Thus, the programmer cannot use a 
previously-defined area defining literal, or its contents, 
after a ltorg. The area defining literal must be re- 
defined. 
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Figure 75. The ltorg Statement 



END — End Subprogram and Assembly 

The end statement must be the last card in the source 
program. The end statement directs the processor to 
start assigning all unassigned literals at this relative 
address in the subprogram. 

If the operand field is blank, end signals the proc- 
essor that all source program entries have been read. 
This form of the end statement is used to specify the 
end of a secondary subprogram. 

If the operand field is not blank, it also specifies the 
end of a primary subprogram and indicates its entry 
point (Figure 76). 
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Figure 76. The end Statement 

SPEND — End Subprogram 

The spend statement is used when assembling two or 
more subprograms with the same symbol table used 
throughout the assembly. The spend statement indi- 
cates the end of a subprogram and directs the proc- 
essor to process all unassigned literals at this point 



of the subprogram. The spend statement implies that 
another subprogram to be assembled will follow. 

The same formats used for the end statements are 
used for the spend statements. If the spend statement 
is written with an operand, the resultant output will 
be the same as that produced by an end statement with 
an operand ( primary subprogram ) . If there is no oper- 
and, the output will be exactly the same as for the 
end statement without an operand (secondary sub- 
program). (See Figure 77.) 

Note: The spend statement must be followed by the 
title card of the next subprogram. ( headr, reseq, and 
eject statements can intervene.) 



If a source statement that can produce a load card 
in the object deck appears after a spend statement, and 
before a title statement, the processor places a "W" 
flag on the first statement of the load card. 
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Figure 77. The spend Statement 
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The Macro System 



The macro system enables the programmer to extract 
from a library of macro routines a sequence of instruc- 
tions tailored by the processor to fit his particular pro- 
gram needs. This sequence of instructions is inserted 
automatically in the object program. This ability of 
Autocoder to process macro-instructions relieves the 
programmer of much repetitive coding. 



Definitions of Terms 

The special terms used in describing the requirements 
and characteristics of the macro system are defined 
below. 

Macro-Instructions: A symbolic instruction written 
in the source program that causes a series of machine- 
language instructions to be inserted in the object 
program. 

Object Routine: The specific machine-language in- 
structions needed to perform the functions specified by 
a macro-instruction. An object routine is inserted 
directly into a program without a linkage or calling 
sequence. The routine is placed in the object program 
each time its associated macro-instruction is encoun- 
tered by the processor. 

Model Statement: Model statements appear in the 
macro library routines. They establish the conditions 
for inserting parameters in the object routine and de- 
fine the basic structure of the symbolic program entries. 
They include pseudo-macro statements and symbolic 
entries. 

Macro Routine: The complete set of model state- 
ments from which an object routine is developed by 
the processor. The form of an object routine depends 
upon the parameters given in the macro-instruction. 

Macro Library: The macro library contains the com- 
plete set of macro routines stored on the System Oper- 
ating File. Each routine has an identifying label. 

Librarian: The librarian is that phase of the System 
Generator that produces and maintains the macro 
library on the System Operating File. The user should 
refer to the publication, System Generation, Form C28- 
0352, for information concerning the procedures for 
the production and maintenance of the macro library. 

Parameters: Parameters are the elements in the oper- 
and fields of macro-instructions. Parameters can refer- 
ence literals, actual addresses, or data fields to be 
inserted in symbolic program instructions generated 
from the model statements. 



Pseudo-Macro Statements: A pseudo-macro state- 
ment appears only within the macro library. It is used 
internally by the processor to control the production 
of a series of object program instructions. 



/Macro Operations 

The entries that will subsequently appear in the object 
program are placed on the library tape at system gen- 
eration time. The function of the macro-instruction is 
to direct the processor in selecting the specific entries 
desired by the programmer. The entries selected be- 
come a routine designed to perform a specific function. 

To illustrate the basic operation of the macro system, 
a hypothetical macro called check, with a simple 
library routine, is used. The routine is designed to com- 
pare the contents of an input area to the contents of 
another area, test the compare indicator for a high, 
equal, or low condition, or any combination of the 
three. 

Figure 78 shows the Library Coding Form used with 
the 1410/7010 Macro System. 

Figure 79 shows the following: 

1. The entries on the Library Coding Form. 

2. The macro-instruction that specifies to the proc- 
essor that all the instructions in the library routine are 
required and must appear in the object program. 

3. The symbolic program entries generated by the 
processor. (The processor will subsequently translate 
these symbolic entries into machine language and in- 
sert them in the proper juncture of the object deck.) 

General Description: Model statements are used to 
describe all entries in a macro routine. They include 
pseudo-macro as well as symbolic program statements. 

The Programmer: The programmer plans and codes 
the following: 

1. Designs a general routine to perform specific 
functions (depending upon the parameters supplied) 
when it is executed in the object program. 

2. Writes the model statement as follows: 

a. If the entry is complete (no substitution), it is 

written on the library coding sheet as if it were 
an entry in a source program. This entry will 
be included in all object routines unless a by- 
pass condition exists (see "bool"). This is il- 
lustrated in Figure 80. 

b. If the entry is incomplete, the programmer 
writes a special four-character code to indicate 
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Figure 78. ibm 1410/7010 Library Coding Form 
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Figure 79. Macro Operations 



Figure 80. Model Statement for a Complete Instruction 



that a corresponding parameter from the macro- 
instruction operand field must be inserted in its 
place. This code is a n followed by a number 
from 001 to 199, that indicates the position of 
the parameter in the macro-instruction. The 
macro-instruction in the source program will 
give the parameter entries to be inserted in the 
object routine. The model statement is illus- 
trated in Figure 81. 
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Figure 81. Model Statement for an Incomplete Instruction with 
Required Parameters 

c. If the entry is incomplete, the programmer writes 
a □ followed by a number from 001 to 199 with 
ab bits over the units position (parameter 001 
is dOOA, parameter 2 is nOOB, etc. ) . This indi- 
cates that the entry is to be included in the 
object routine only if the parameter is specified 
by the macro-instruction. For example, if pa- 
rameter 003 does not appear in the macro- 
instruction, the instruction shown in Figure 82 
will be deleted from the object routine. 
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Figure 82. Model Statement for an Incomplete Instruction with 
Conditional Parameters 

Labeling: If the model statement represents an in- 
struction entry point for a branch instruction elsewhere 
in the program, it should have a label. 

If additional external labels are required and speci- 
fied as parameters in the macro-instruction they can 
be inserted in the label field of the symbolic program 
entry by using the nOOl-199 code. 

The label of the macro-instruction causes the genera- 
tion of an equate statement in the assembled object 
routine. The label is equated to an *, as shown in 
Figure 83. 



Another example is shown in Figure 84. 

Symbolic Addressing within the Library Routine: 
To allow a symbolic reference to other instructions in a 
library routine a n followed by a number from 001 to 
199 with a B bit over the units position ( nOOJ = sym- 
bolic address 1, nOOK = symbolic address 2, etc. ) can 
be used. For example, the processor generates the sym- 
bolic address if the code nOOJ is used as a label for one 
entry and as an operand of at least one other entry in 
the same library routine. 

Internal labels within flexible routines are generated 
in the form □nnnmmm, where nnn is the code (00J- 
09R), and mmm is the number of the macro within 
the source program. This is done to avoid duplicate 
address assignments for labels. 

Example: Use the generated symbolic address of 
□00J as an operand for entry 3 and as the label for 
entry 6. updat is the 23d macro encountered in the 
source program (Figure 85). 

Address Adjustment and Indexing: The parameters 
in a macro-instruction and the operands in partially 
complete instructions in a library routine can have 
address adjustment and indexing. 

If address adjustment is used in both the parameter 
and the instruction, the assembled instruction will be 
adjusted to the algebraic sum of the two. For example, 
if the address adjustment on one is +7 and the other 
is —4, the assembled instruction will have address 
adjustment equal to +3. 

Model statement operands can be indexed. This in- 
dexing takes precedence over any indexing of a param- 
eter supplied by a macro-instruction. The model state- 
ment index is used. 

Literals: Operands of instructions in library routines 
may use literals as required. However, these literals 
may not contain the @ symbol within an alphameric 
literal. 
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Assembled Symbolic Program Entry 



Assembled Symbolic Program Entry 
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START2 SBR ENTRYA 

Figure 84. Additional External Labels 
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Assembled Symbolic Program Entry 



B 



□ 00J023 



□ 00J023 ZA COST, AMOUNT 

Figure 85. Internal Labels 

Note 1: A model statement in the library routine for 
a macro-instruction may not be another macro-instruc- 
tion. 

Note 2: end statements cannot be used in library 
routines. 

The Processor enters model statements in the library 
tape immediately following the header statement dur- 
ing System Generation. 

Result: Any library routine can be extracted by writ- 
ing the associated macro-instruction in the source 
program. 

Figure 86 is a summary of the codes that can be 
used in the model statements of library routines. 



CODE 


POSITION 


FUNCTION 


□ 001 - nl99 


Statement 


Substitute parameter 
(parameter must be present) 


□ 00A- n 191 


Statement 


Substitute parameter (if 
parameter is missing, 
delete statement) 


nOOJ - ci 19R 


Label Field and 
Operand Field 


Assign internal label 



Figure 86. Model Statement Codes 

General Description: A macro-instruction is the entry 
in the source program that causes a series of instruc- 
tions to be inserted in a program. 

The Programmer: 

1. Writes the name of the library routine in the 
operation field. 



2. Writes the label that is to reference the first as- 
sembled model statement. A label equ * is generated 
to do this. 

3. Writes the parameters that are required for the 
particular object routine desired. These parameters, 
used by the model statements, are written as follows: 

a. Parameters must be written in the sequence in 
which they are to be used by the codes in the 
model statements. For example, if cost is 
parameter 001, it must be written first so that it 
will be substituted wherever a nOOl or nOOA 
appears as a label, operation code, or operand 
of a model statement. 

b. As many parameters may be used as can be 
contained in the operand fields of five or fewer 
coding sheet lines. If more than one line is 
needed for a macro-instruction, the label and 
operation fields of the additional lines must be 
left blank. Parameters must be separated by a 
comma. They cannot contain blanks or commas 
unless they appear between @ symbols. The 
@ symbol itself cannot appear between @ sym- 
bols. Also, the @ symbol can be used only in 
pairs as a literal identifier. It cannot be used 
in any other way; e.g., a single @ symbol could 
not be used to represent the d modifier of a 
macro-instruction. If parameters for a single 
macro-instruction require more than one coding 
sheet line, the last parameter in each line must 
be followed immediately by a comma. The 
last parameter in a macro-instruction should 
not be followed by a comma. 

c. Parameters that are not required for the par- 
ticular object routine desired can be omitted 
from the operand field of the macro-instruction. 
However, if a parameter is omitted, the comma 
that would have followed the parameter must 
be included, unless the omitted parameter is 
behind the last parameter which is included in 
the macro-instruction. These commas are nec- 
essary to count parameters up to the last in- 
cluded parameter. All parameters between the 
last included parameter and parameter 199 are 
assumed by the processor to be absent. 

Figures 87, 88, 89 and 90 show how parameters can 
be omitted. The hypothetical macro-instruction called 
exact is used, exact can have as many as nine 
parameters. 

The Processor extracts the library routine and selects 
the model statements required for the object routine 
as specified by the parameters in the macro-instruc- 
tions, and by substitution and switches set by bool or 
comp in the model statements. 
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Figure 87. Parameter for exact. 006-199 Missing 
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Figure 88. Parameters 004 and 006-199 Missing 
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Figure 89. Parameters 001, 004-006, 008 and 010-199 Missing 
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Figure 90. Parameters 001 and 003-199 Missing 



Pseudo-Macro Instructions 

These statements never appear in a user's source pro- 
gram or in the output listing of an assembled Auto- 
coder program. However, they are used in library 
routines to signal the processor that certain conditions 
exist which can affect the assembly of an object routine. 
For example, the presence of a pseudo-macro- 
instruction in a library routine can cause a group of 
model statements to be deleted. Thus, pseudo-macros 
provide the writer of library routines with a coding 
flexibility which exceeds the limitations of the substitu- 
tion and condition codes described previously. 

Pseudo-macro-instructions may be written anywhere 
in a library routine. The five pseudo-macros incorpo- 
rated in the Autocoder processor are math, bool, 
comp, note, and mend. 

Permanent and Temporary Switches 

The math, bool, and comp pseudo-macros use internal 
indicators (switches) to signal the processor of exist- 
ing status conditions. 

There are 099 permanent and 199 temporary 
switches available for recording status conditions. Each 
switch occupies one core-storage position during the 



macro generator phase of Autocoder. If a storage posi- 
tion contains the character A (abI bits), the switch is 
on; if it contains a ? (cab 82 bits), the switch is off. 
At the beginning of assembly all switches are off. 

Permanent Switches: Permanent switches retain 
status conditions during the entire macro generator 
phase unless changed by a pseudo-macro. They are 
addressed by using a # symbol followed by the three- 
digit number of the switch to be set or tested. For 
example, #001 addresses permanent switch 001; #002 
addresses switch 002; and #099 addresses switch 099. 

Temporary Switches: When the processor encounters 
a macro-instruction, the temporary switches are set to 
the condition ( presence or absence ) of the parameters 
in the operand of the macro field. If the parameter is 
present, the corresponding switch is set on. If the 
parameter is missing, the switch is set off. For ex- 
ample, if parameter 001 is present, temporary switch 
001 is turned on. If parameter 002 is missing from the 
macro-instruction, temporary switch 002 is off. Tem- 
porary switches retain status throughout the processing 
of a macro-instruction unless changed by a pseudo- 
macro. After the macro-instruction has been completely 
processed, all temporary switches are set off. Tempo- 
rary switches are addressed by using a n symbol fol- 
lowed by the three-digit number of the switch to be set 
or tested. For example, nOOl addresses temporary 
switch 001; n002 addresses switch 002; and P199 ad- 
dresses switch 199. 

If a macro with a maximum of nine parameters is 
encountered, the processor sets the first nine temporary 
switches to indicate the presence or absence of these 
nine parameters. Temporary switches 010-199, which 
are off, can be used by the pseudo-macros to com- 
municate conditions to the processor while it is working 
on this particular macro-instruction. This use of tempo- 
rary switches is recommended because it reserves the 
permanent switches for communicating information 
from one macro to another. 



MATH — For Solving Algebraic Expressions 

A math pseudo-macro contains as operands: sum 
boxes, arithmetic expressions, and sign switches. 

Sum Boxes: A sum box is a group of five core- 
storage positions used to store the result of an arith- 
metic expression. Autocoder makes available 20 such 
sum boxes. A sum box is addressed by using a # 
symbol followed by the three-digit number (ending 
in zero or five) of the sum box to be referenced. For 
example, the address of the first sum box is #005; the 
address of the second sum box is #010; and the address 
of the twentieth sum box is #000. 

At the. beginning of the macro phase, a sum box 
contains 00000. Any number may be placed in a sum 
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box or added to its contents. The units position of the 
sum box always contains the sign of the result. Sum 
boxes retain information placed in them throughout the 
macro phase, and their contents may be used and/or 
changed from one macro-instruction to another. 

Sum boxes can be used by model statements as well 
as by a pseudo-macro. For example, in Figure 91, as- 
sume that sum box #005 contains 12345 and sum box 
#010 contains 00015. 

Note: za fldI + 0001N,fld2 is processed as za 
fldI — 15,fld2. 
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Assembled Symbolic Program Entry 

ORG 1234E 

ZA FLD1+0001N,FLD2 

Figure 91. Sum Boxes 

Arithmetic Expressions: Arithmetic expressions within 
the math pseudo-macro use add ( + ) , subtract ( — ) , 
multiply (*), and divide (/). An @ symbol represents 
both the left and right parentheses if they are required 
for the expression. For example, 
(001 + 12-5) 20 is written: @001 + 12-5@*20. 

Multiplication and division are done before addition 
and subtraction by the math pseudo-macro, unless 
otherwise indicated by the use of @s. The quotient 
resulting from the divide operation is not half-adjusted, 



and the remainder is lost. At the end of a multiplica- 
tion operation the five low-order positions of the 
product are used for the result. ( The high-order digits 
are lost. ) An overflow is ignored. 

The result of the arithmetic expression is inserted 
with its sign in the designated sum box. 

Sign Switches: Permanent and temporary switches 
may be used to store the sign of the result of an arith- 
metic expression. The first switch specified in the oper- 
and field of the pseudo-macro represents a positive 
result; the second represents a zero result; and the 
third represents a negative result. Consequently, one 
switch is on and the other two are off if the result is 
either positive or negative. A zero result causes both 
the zero and positive switches to be set on. It is not 
necessary to specify all three switches. However, if a 
switch code is omitted from the operand field, the 
comma that would have followed the switch code must 
be present. (This is the same rule that applies to 
omitted parameters in a macro-instruction. ) 

The Programmer: 

1. Writes the name of the pseudo-macro (math) in 
the operation field. 

2. Writes in the operand field: 

a. The code for the sum box in which the result 
of the arithmetic expression is to be stored. 

b. The arithmetic expression. 

c. The code for the switch in which the sign(s) of 
the result are to be stored. 

Note: A comma must follow the sum box code, the 
arithmetic expression, and the individual sign-switch 
codes. Figure 92 shows the format for a math pseudo- 
macro. 

The Processor: 

1. Produces the result of the arithmetic expression. 

2. Stores the result in the sum box. 

3. Sets the sign switches. 

Example: The math pseudo-macro shown in Figure 
93 multiplies parameter 07 by 401 and adds 12 to the 
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Figure 92. Format for the math Pseudo-Macro 
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Figure 93. math Pseudo-Macro 
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Figure 94. Format for the bool Pseudo-Macro 



result. The answer is stored in sumbox 6 ( #30). If the 
result is positive, permanent switch 04 is set on; if the 
result is zero, switches 04 and 06 are set on; if the re- 
sult is negative, switch 09 is set on. 

BOOL — For Solving Logical Expressions 

General Description: The bool pseudo-macro can be 
used to set a permanent or temporary switch as the re- 
sult of a logical expression, or to cause the processor 
to skip over certain model statements if the logical 
expression is false. If the statement is true, the proc- 
essor goes to the next sequential model statement. 

The Programmer: 

1. Writes the name of the pseudo-macro (bood in 
the operation field. 

2. May write a special one-character label, the 
logical expression (statement), and a switch code in 
the operand field in the format shown in Figure 94. 

Labeling: A special one-character label permits skip- 
ping forward in the library routine as the object rou- 
tine is being assembled by the processor. This one- 
character label is written in the first position of the 
operand field of the bool pseudo-macro and also in the 
label position (column 6 of the library coding form) 
of the first model statement ( or command ) to be exam- 
ined after the skip has been initiated. Skipping occurs 
only if the logical statement is false. The label may be 
omitted if a skip is not desired, but the comma that 
would have followed the label must be written in the 
bool statement to indicate that the label is missing. 
The label can be any alphabetic or numeric character. 
Special characters are not permitted. 

Logical Expression: The bool pseudo-macro can 
have any combination of three logical operations: 
* (and), 4- (or), and — (not). The operators are de- 
fined in Figure 95. The combination of these operators 
and the switches to be tested make up the logical ex- 
pression. (See, for example, Figure 96.) 

The @ symbol is used to represent both the left and 
right parentheses. 
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1*1 = 1 


1 + 1 = 1 


-1 =0 
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0+1=1 
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Switches: Either a permanent or temporary switch 
may be used to store the result of the logical expres- 
sion. If the expression is true, the specified switch will 
be set on. If the expression is false, the specified switch 
is set off. If no switch setting is desired, a comma must 
be used to indicate that the switch is missing. 

The Processor: 

1. Examines the status switches to determine 
whether all conditions specified in the logical expres- 
sion are satisfied. If they are, the expression is true. If 
the logical condition is not met, the expression is false. 

2. Sets the specified status switch to on or off to 
reflect the true or false condition. 

3. If a false condition exists and a label appears in 
the bool operand, the processor skips forward to the 
command or model statement containing a correspond- 
ing label in its label position. 

To determine if a logical expression is true or false: 

a. Consider all on conditions true and all off con- 
ditions false. 

b. Let 1 = true and = false. 

c. Calculate the logical value of the expression. 
If the logical value of the expression is zero, the ex- 
pression is false. If the logical value is one, the expres- 
sion is true. For example, if switches 001, 002, 003 and 
004 are on, the expression 

@n001*n002@ + @n003*n004@ 
is true because: 

(on*on) + (on*on) = 

(1*1) + (1*1) = 
1+1 = 1 

Examples: Figure 96 shows how the bool pseudo- 
macro can be used. The bool entry states: 

1. If temporary switches 001 and 002 are on, the 
statement is true. Therefore, set temporary switch 
015 on. 

2. However, if either temporary switch 001 or 002 



Page 
and 
Line 


L 


Label 


Operation 




12 3 4 5 


6 


7 8 9 101112131415161718192021 


222324 25 26 


272829303132333435363738394041424344/ 












































B 








L 




L 


> 


a 








I 


* 


n 








2 


> 


u 





» 


5 
















































A 










F 


1 


E 


L 





A 


} 


F 


1 


E 


L 


D 


B 






















































B 










E 





J 










































L 
































C 










A 


R 


E 


A 


X 


y 


A 


R 


E 


A 


2 









































































































Figure 95. Table of Operators 
46 



Figure 96. Using the bool Pseudo-Macro 



is off, the statement is false. Therefore, set temporary 
switch 015 off and skip to statement 004. 
The example shown in Figure 97 states: 

1. If both temporary switches 001 and 002 or both 
temporary switches 003 and 004 are on, the state- 
ment is true. Therefore, set temporary switch 015 

ON. 

2. However, if either temporary switch 001 or 002 
and either temporary switch 003 or 004 is off, 
the statement is false. Therefore, set temporary 
switch 015 off and skip to the model statement 
whose label is L. 



SWITCHES 




001 


* 


002 


+ 


003 


* 


004 


= 


LOGICAL VALUE 


OFF 



* 


OFF 



+ 


OFF 



* 


OFF 



_ 





ON 
1 


* 


OFF 



+ 


OFF 



* 


OFF 








OFF 



* 


ON 
1 


+ 


OFF 



* 


OFF 



= 





OFF 



* 


OFF 



+ 


ON 
1 


* 


OFF 








OFF 



* 


OFF 



+ 


OFF 



* 


ON 
1 


_ 





OFF 



* 


ON 
1 


+ 


OFF 



* 


ON 
1 


_ 





ON 
1 


* 


OFF 



+ 


ON 
1 


* 


OFF 



_ 





OFF 



* 


ON 
1 


+ 


ON 
1 


* 


OFF 



- 





ON 
1 


* 


OFF 



+ 


OFF 



* 


ON 
1 


= 






Figure 97. bool Pseudo-Macro 



Figure 99. False Conditions 



Figure 98 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
true. 

Figure 99 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
false. 



COMP — To Compare Two Fields 

General Description: The comp pseudo-macro com- 
pares an A-field to a B-field (maximum of 15 charac- 
ters), and sets permanent or temporary switches to 
indicate the result of the comparison. 

The Programmer: 

1. Writes the name of the pseudo-macro (comp) 
in the operation field. 
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2. Writes the operand field in the format shown in 
Figure 100. The first and second entries are the A- and 
B-fields. The A- and B-fields may be any of the 
parameters 001-199, sum boxes #005-#000, or literals. 
They cannot be switches. 

Note 1: For the comp pseudo-macro, alphameric 
literals are not enclosed by @ symbols. Entries 3, 4, 
and 5 are high, equal, and low switches. 

Note 2: The codes for the two fields to be compared 
must be present in all comp pseudo-macro-instructions. 
Codes for the switches may be omitted if they are not 
needed to store the result of the compare operation. 
However, if a 'switch is omitted, the comma that 
would have followed it must be included in the 
operand field. 

Note 3: B-field controls compare. (High-order posi- 
tion of B-field ends compare. ) 
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Figure 98. True Conditions 



Figure 100. Format for comp Pseudo-Macro 



The Processor: 

1. Compares the A-field to the B-field. 

2. Sets one status switch on and two switches off 
to reflect the result of the comparison. 

a. The first switch is set on, if the value of the 
B-field is greater than that of the A-field. 
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b. The second switch is set on, if the B-field is 
equal to the A-field. 

c. The third switch is set on, if the value of the 
B-field is less than that of the A-field. 

Examples: Figure 101 shows a comp pseudo-macro 
which states: 

1. Compare parameter 002 of the macro statement 

tO WORKAREA. 

2. If parameter 002 is equal to workarea, turn on 
temporary switch 25. 

3. If workarea is less than parameter 002, turn on 
temporary switch 26. 
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Figure 101. comp Pseudo-Macro 



The message is printed in line on the output device 
(tape or on-line printer). In addition, an !< N" will be 
automatically inserted in the flag field of the assembly 
listing. 

The Programmer: 

1. Writes the name of the pseudo-macro (note) in 
the operation field. 

2. Writes the message in the operand field. 

The Processor: Prints the message on the Standard 
Print Unit (tape or on-line printer). 

Examples: Figure 104 shows how the note pseudo- 
macro can be used in combination with the bool 
pseudo-macro. The bool pseudo-macro tests to ensure 
that parameters 001 and 002 are present in the macro- 
instruction. If either parameter is missing, the proc- 
essor skips to the note pseudo-macro and prints: 

PARAMETER ABSENT FROM MACRO. 



Figure 102 shows a comp pseudo-macro which 
states: 

1. Compare the contents of sum box 005 to param- 
eter 003 of the macro statement. 

2. If the result is high, set temporary switch 024 on. 

3. If the result is equal, set temporary switch 025 

ON. 

4. If the result is low, set temporary switch 026 on. 
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• Figure 104. note Pseudo-Macro 
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Figure 102. Comparing a Parameter to the Contents of a 
Sum Box 



Note: Standard 1410/7010 collating sequence deter- 
mines high, equal, or low conditions. Comparisons 
are controlled by the B-field. Thus, the statement 
shown in Figure 103 will cause temporary switch 025 
to be set on if the low-order position of parameter 
002 is a 3. 

NOTE — To Produce a Message 

General Description: The note pseudo-macro is used 
to write messages concerning conditions that can arise 
during the processing of a macro-instruction. 
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Figure 103. Checking for a Single Character 
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MEND - End of Routine 

General Description: This pseudo-macro signals the 
end of generation for a macro-instruction. It may ap- 
pear anywhere in a library routine. 

The Programmer: 

1. Writes the name of the pseudo-macro (mend) in 
the operation field. 

2. Leaves the operand field blank. 

The Processor: Stops processing the macro-instruc- 
tion when it encounters a mend statement. Figure 105 
shows a mend pseudo-macro. 

Note: A bool pseudo-macro can be used to skip 
over a mend pseudo-macro which appears within the 
library routine if conditions indicate that more model 
statements must be processed. 
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Figure 105. mend Pseudo-Macro 



Pseudo-Macro Coding Example 

Example: Figure 106 shows the library entry for a 
hypothetical macro called prlit. This library routine 
uses all of the five pseudo-macros. It illustrates the 
effect of the pseudo-macros on the processing of a 
macro-instruction. The meaning of each line in the 
library routine is: 

Entry 1: If parameter 001 is present, set temporary 
switch 050 off and go to entry 3. If parameter 001 is 
missing, go to entry 2. 

Entry 2: Print the note: operand 001 absent. 



Page / 
and L Label Operation 1 
Line \ 


12 3 4 5 6 7 8 9 1011 12 13 14 IS 161718 192021 2223242526 2728293031 32333433363738394041 42434*1 


0\00\ &0OL A^-dOOl^fclOSO ~\ 


O\00Z MOTE OPERANP 0OJ ABSENT? 


OI0O3A BOOL A^OIO J 


1004 0R& #005 7 


O\005\ SdATH £005^005+120^*} J 


olOOfc S0R aOOK+5 1 


01007 M ixA §00000^0003 J 


01OQ1 a +3^003 J 


01009 B 0004 


01 010 C0MP D002,g it Q051 t 


O'OI 1 BOOL 6^051, 


O\0\z v\ic,£ boo2,nooi j 


01013 s 1 aooz,aooF 


31014 yi.e acos^accs ~] 


DICfS D00K B0 


01016 goOL ^-0051, 


01017 VLCA 1^0021^0001 1 


01 01 BO NfeNP ,' 


:::::::::::::::::::::::::::.::::::::_:::::::_1 



• Figure 106. prlit Library Routine 



Entry 3: If permanent switch 010 is off, go to entry 

5. If permanent switch 010 is on, take entry 4. 
Entry 4: org at the contents of sum box #005. 
Entry 5: Put the contents of sum box #005 plus 100 

in sum box #005. 

Entry 6: Store the contents of the B-address register 
in an address equal to the address assigned to the 
internal label (nOOK) +5. 

Entry 7: Move five zeros to the field whose symbolic 
address is parameter 003 of the macro-instruction. 

Entry 8: Add the literal +3 to the field specified by 
the parameter 003. 

Entry 9: Branch to parameter 004. 

Entry 10: If parameter 002 is a literal, the equal 
switch ( n051 ) is set on. 

Entry 11: If the equal switch (temporary switch 51) 
is off, skip to entry 15. If the equal switch is on go 
to entry 12. 

Entry 12: Move parameter 002 to parameter 001. 

Entry 13: Subtract parameter 002 from parameter 

006. (If parameter 006 is missing, this statement will 
be bypassed. ) 

Entry 14: Move parameter 003 to parameter 005. 

Entry 15: Branch to 

Entry 16: If temporary switch 051 is on, skip to entry 
18. If temporary switch 051 is off, go to entry 17. 

Entry 17: Insert parameter 002 as a literal, and 
move it to the field indicated by parameter 001. 

Entry 18: End of library routine. 

Assume that: 

1. The macro shown in Figure 107 is encountered in 
the source program. 

2. Permanent switch 010 is on. 

3. Sum box #005 contains 12345. 



Macro Instruction 



Line 
2 S8_ 



Label 



Operation 

is. 



il 8fi_ 



_2fi_ 



JO. 



_4fl_ 



OPERAND 
—18 8fi_ 



-54. 



-ftfi_ 



-SJL 



JUL 



P.g.LJ.T A.f .E.A.i. f .fe4,2.A.Bi6>. r F.t.E.L.D.l, f .E. X: I.T.I. r W,Q,R,KAR.e.A, 



flA 



_« i i i i—i — i — i i i—i i i i i_i u 



Assembled Symbolic Program Entry 



ORG 12345 

SBR n 00K023+5 

MLCA @00000@, FIELD1 

A +3, FIELD1 

B EXIT1 

MLCA @42AB@,AREAA 

MLC FIELD1, WORKAREA 

B 



Figure 107. Using the prlit Routine 
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SOURCE PROGRAM 



S 
Y 
M 
B 

O 
L 
I 
C 

P 
R 
O 
G 
R 
A 
M 

E 
N 
T 



Source Program 
Statement 



Macro-instruction 



Source Program statement 
following macro-instruction 



PROCESSOR OPERATIONS 



Extract library routine 



Substitute parameters in 
model statements wherever 
substitution codes appear 



Delete model statements if 
bypassing conditions are 
satisfied 



Insert assembled symbol ic pro- 
gram entries as an open routine 
in the symbol ic program 



When a macro-instruction is encountered in the 
source program, the processor extracts the specified 
library routine, tailors it, and inserts it in-line 
in the users source program. 



Figure 108. Macro Processing 
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Appendix A: Processor Error Diagnostic Procedures 



The following chart lists the seven flag codes which 
the Autocoder processor will affix to an Autocoder 



statement upon diagnosing an error. The circumstances 
which will produce each flag are also described. 



FLAG DEFINITION 

F Format Invalid 



M Multiple Definition 

N Note Generated 

O Operation Invalid 

R Restricted Operation 

U Undefined Label 

W Warning 



CIRCUMSTANCES 



The operand of each statement is analyzed for correct format. Invalid for- 
mat testing is not 100% exhaustive. The list included below indicates the 
areas in which format testing is conducted. ( See Note 2. ) 

A label ( or labels ) in the operand has been defined more than once in the 
source program. The address of the first encountered label is used. Note 1 : 
See indexing restriction of X14 and X15. 

This flag is caused by a macro generation and is not necessarily a program- 
ming error. ( See "Note — To Produce a Message" under "The Macro 
System." ) 

The operation code of the statement is a mnemonic that does not exist in the 
Autocoder language and is not one of the macro-instructions contained in 
the macro library. ( See "Mnemonic Operation Codes," Figure 21. ) 

The operation code of the statement is one of the restricted operation codes. 
( See Appendix D. ) The "R" flag does not set the "no-go" switch. 

A label (or labels) in the operand has not been defined by another state- 
ment in the source program. ( See Note 2. ) 

This flag is used to indicate improper program conditions. For example, the 
processor must encounter a title card after a spend card before it gen- 
erates another card in the object deck. Another example is: an ORG * -I-X00 
must be preceded by a basei * +X00. 



Note 1 : If a label is defined as an area defining literal and as 
a label in another Autocoder statement, this error will not re- 
ceive the "M" flag. The cross reference listing, however, will 
diagnose this condition and give notice of the multiple definition. 

Note 2: Certain labels are exempt from these requirements. 
They are linkage symbols, system symbols, index register sym- 
bols (Xl-15, +X0) and common. 

Invalid Operand Relationships Causing the "F" Flag: 

1. No operand information in a statement that requires addi- 
tional information. 

2. Comments not separated from operand elements by at least 
two blanks, 

3. Incorrect DA or DAV header configuration. 

4. A label used as an address adjustment is not equated to 
an index register, and the statement is not a DC or DCW entry. 



5. Invalid sequence of sensitive characters. Sensitive charac- 
ters in the operand are: 

BLANK - b 

COMMA - , 

PLUS - + 

MINUS 

At Symbol - @ 

Asterisk - * 

Pound Sign - # 

6. Incorrect information following a sensitive character, 
such as 

+b or *A. 

7. A pound sign not followed by a pure numeric count less 
than or equal to 500. 

8. A literal without a literal character, for example, 
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Appendix B: Autocoder Messages and Limits 



This appendix contains a listing of all the messages 
produced by Autocoder, a description of the circum- 
stances causing the message, and" a table of the limits 
of the Autocoder processor. 

The processor can produce the following messages 
on the console printer and on the /spr/ file. When the 
message is found necessary, the go mode will be can- 
celled and the assembly terminated at the point where 
the condition occurred. If the job is not in the test 
mode, this will cause the System Monitor to cancel 
the remainder of the job. 

10701 AUTOCODER NOT COMPLETED. UNCORRECTABLE I/O 
ERROR (ON MWn) TERMINATED IN PHASE X 

This message will have been preceded by the standard 
iocs message on the console printer indicating a data 
check or wrong-length record. In some cases the work 
file number is given. 

10701 AUTOCODER NOT COMPLETED. UNUSUAL (Or UNEX- 
PECTED) END OF FILE ON MW1 TERMINATED IN 
PHASE X 

( A similar message may be produced which indicates 
MW2 and MW3. ) This message will be produced on an 
unexpected end-of-file or end-of-reel indication when 
the system is using tape work files, or an end of the 
•tracks assigned to the given 1301 disk work file. 

10701 AUTOCODER NOT COMPLETED. LIBRARY DIRECTORY 
NOT FOUND TERMINATED IN PHASE 1 

This message will be produced when the library direc- 
tory is not contained in the sof. 



10701 AUTOCODER NOT COMPLETED. MACRO LIBRARY NOT 
FOUND TERMINATED IN PHASE 1 

This message will be produced when the macro library 
is not contained in the sof. 

10701 AUTOCODER NOT COMPLETED. RECURSION CAPACITY 
EXCEEDED TERMINATED IN PHASE 3 

This message will be produced when the maximum 
number of literals is exceeded in a source program ( see 
chart below). The source program will have to be 
altered before assembling. 

10701 AUTOCODER NOT COMPLETED. MAXIMUM NUMBER 
OF DTFS EXCEEDED TERMINATED IN PHASE 1 

This message will be produced when the maximum 
number of dtf's has been exceeded in a source pro- 
gram ( see chart below ) . The source program will have 
to be altered before assembling. 

10701 AUTOCODER NOT COMPLETED. ERROR IN MACRO 
LIBRARY READ TERMINATED IN PHASE 2 

This message will be produced when an error is read 
in the Macro Library. 

10701 AUTOCODER NOT COMPLETED. MACRO XXXXX NOT 
FOUND ON DISK TERMINATED IN PHASE 2 

This message will be produced when the specified 
Macro Library routine, xxxxx, is not found on the 
disk file. 

10702 NOGO SWITCH SET 

This message is produced when a source statement is 
flagged (except for the "R" flag). 



Affecting 

Macro- 
Instructions 



Autocoder 
Statements 



Literals 



AUTOCODER LIMITS 

Maximum Reason 

240 different macros in the macro library Table size is limited 



9999 macro-instruction usages within one 
assembly run 

25 DTF usages in one assembly run 



The total number of Autocoder statements 
(source and generated) is limited by one 
reel of tape, or by the number of disk cylin- 
ders assigned to each work file. 



x — y — z 
16 



Approximate literal limit = 

Where: x = contents of /AMS/ 

y = address of IBAU30SUBR de- 
fined in the System Generation 
memory map. 

z = 3,000 plus 16 times the number 
of EQU, ORG, and LTORG 
statements containing symbolic 
operands within each assembly. 



Limit of generated 
labels 

Table size is limited 



No multi-reel process- 
ing on tape, or end of 
tracks assigned to a 
work file on disk 

Work area in core 
storage of the SOF has 
been exceeded 



Results when Exceeded 

Diagnostic message and 
System Generation ter- 
mination 

Possibility of multiple 
label definitions 

Diagnostic message and 
assembly termination 

Diagnostic message and 
assembly termination 



Diagnostic message and 
assembly termination 
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Appendix C: 1410/7010 Autocoder Sample Program 



The following sample program is provided both as a 
test deck for the user's System Operating File and as a 
teaching aid. It is an Autocoder source program with a 
set of dummy input which is combined with control 
cards to constitute a Monitor job run. The card deck 
( Exhibit I ) is loaded via the Standard Input Unit. The 
job run includes the assembly of the source program 
by the Autocoder processor, the creation of the ab- 
solute program by the Linkage Loader, and the execu- 
tion of the sample program which results in output on 
the Standard Punch Unit. 

The assembled object program will perform the fol- 
lowing functions: 

1. Reproduce card decks in card columns 6-75. 

2. Sequence the deck, punching the sequence num- 
ber into columns 1-5. 

3. Gang punch the contents of columns 76-80 of the 
first card into the corresponding columns of the 
remainder of the deck. 



4. Type the message "EOJ" on the console printer at 

end of job. 
The exhibits are as follows: 

Exhibit I The assemble-and-go input deck. 

Exhibit II The console printer output during 
the run. 

Exhibit III A listing of the object program deck. 

Exhibit IV The Standard Print Unit output of 
the job run, showing: 

A. Monitor Control Cards 

B. Assembly Listing 

C. Cross Reference Listing 

D. Linkage Loader Control Cards 

Exhibit V A listing of the cards which are the 
output of the executed sample pro- 
gram. 
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MON$$ 


DATE 


64015 






MON$$ 


JOB 


SAMPLE 






MON$$ 


ASGN 


MJB.A1 






MON$$ 


MODE 


GO 






MON$$ 


ASGN 


MGO.A6 






MON$$ 


EXEQ 


AUTOCODER 




0001 




HEADRSAMPLE PROGRAM USING 1410/7010 


AUTOCODER 


0002 




TITLERESEQUENCE 




0003 




BASE1*6X00 




0004 


* 








0005 


* 


THIS PROGRAM WILL RESEQUENCE SOURCE 


DECKS 


0006 


* 


RENUMBERING FROM 0001 IN THE FIRST 


FOUR 


0007 


♦ 


COLUMNS 


AND WITH THE IDENTIFICATION 


FIELD 


0008 


* 


SUPPLIED 


BY THE FIRST CARD GANG-PUNCHED 


INTO EACH 


0009 


♦ 


CARD PRODUCED. 




0010 


# 








0011 


START 


B 


READ 




0012 




MLCB 


AR80.IDENT#5 




0013 




B 


*&8 




0014 


LOOP 


B 


READ 




0015 




B 


CHNG 




0016 




B 


PUNCH 




0017 




B 


LOOP 




0018 


* 








0019 


READ 


SBR 


RDXT&5 




0020 




STD I ORE AD .AREA, EOF, ERROR. M 




0021 


RDXT 


B 







0022 


* 








0023 


CHNG 


SBR 


CHNGX&5 




0024 




MLCA 


IDENT.AR80 




0025 




MLCA 


@ @ 




0026 




MLCS 


@ @,AR04&1 




0027 




A 


&1.CNT#4 




0028 




MLCA 


CNT.AR04 




0029 


CHNGX 


B 







0030 


•» 








0031 


PUNCH 


SBR 


PCHXT&5 




0032 




STDIOPUNCH.AREA 




0033 


PCHXT 


B 







0034 


# 








0035 


EOF 


IOCTLTYPE.EOJ 




0036 




B 


/EOP/ 




0037 


* 








0038 


ERROR 


IOCTLTYPE.ERR 




0039 




B 


/UEP/ 




0040 


# 








0041 




LTORG* 




0042 


* 








0043 


AREA 


DA 


1X80. G 




0044 


AR04 




4 




0045 


AR80 




80 




0046 


♦ 








0047 


EOJ 


DC 


@ EOJ@.G 




0048 


ERR 


DC 


©ERRORS. G 




0049 




PST 






0050 




END 


START 





SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 
SAMPL 



EXEQ LINKLOAD 
PHASESAMPLE 
CALL RESEQUENCE 



MON$$ EXEQ SAMPLE. MJB 

AUTOCODER SAMPLE PROGRAM DECK OF DUMMY INPUT CARDS > 

THIS DECK OF CARDS IS PROVIDED WITH THE SAMPLE PROBLEM TO SUPPLY A 
FEW DUMMY INPUT CARDS FOR OPERATING IN THE ASSEMBLE-AND-GO MODE. 
NOTE THAT THE FIRST CARD - THREE CARDS EARLIER IN THIS DECK - CONTAINS 
FIVE CHARACTERS IN CARD COLUMNS 76 THROUGH 80. AFTER EXECUTION OF THE 
SAMPLE PROGRAM. ALL THE CARDS PRODUCED WILL CONTAIN THESE CHARACTERS 
IN THE CORRESPONDING CARD COLUMNS. NOTE ALSO THAT EACH OF THE CARDS 
PRODUCED WILL CONTAIN A SEQUENCE NUMBER IN CARD COLUMNS 1 THROUGH 5. 
MON$$ END 



Exhibit I 
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tt 00000 

S 14900 lbbbb 11622 bb bbb bbbb 

D 00000 

D bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb 

A AC%B000012$F3 

R DATE 64015 

R S01 JOB SAMPLE 

R ASGN MJB,A1 

R MODE GO 

R ASGN MGO,A6 

R EXEQ AUTOCODER 

R 10101 NR1 M@401<t400W 

R EXEQ LINKLOAD 

R EXEQ SAMPLE, MJB 

R EOJ 

R END 

R END SIU 

R ENTER B MESSAGES 



tt 

Exhibit II 



PAGE 001 

64015 TITLERESEQUENCEOOOOO 5001SAMPL 

BASE1«+X00 4002SAMPL 

00000 00045 J00054 D0039400306L J00033 J00054 J00118 ) ) » D) 1003S AMPL 

00040 00035 J00185 J00026 G00116B J/RSI/ J00216 ) >))1004SAMPL 

00075 00043 W00259/MCS/M D/CRD/00104/ D0000000315* JOOOOO AAC1005SAMPL 

00118 00037 G00183B 00030600394T D00309 D00309003193 D-D) 1006SAMPL 

00155 00044 A0031000314 D0031400318T JOOOOO G00214B Y/PCH/X ) 041007SAMPL 

00199 00005 1008SAMPL 

00204 00036 00315 JOOOOO V00216/CTB/2 Y/CNC/X 00396 N C N1009SAMPL 

00240 00043 V00240/CTB/2 J/EOP/ V00259/CTB/2 Y/CNC/X 00402 N C C1010SAMPL 

00283 00019 V00283/CTB/2 J/UEP/ C1011SAMPL 

00302 00013 A 1012SAMPL 

00315 00395 NY013SAMPL 

00395 00001 1014SAMPL 

00396 00012 EOJ ERROR 1015SAMPL 
E OOOOC 3999SAMPL 

Exhibit III 



MON$$ SOI JOB SAMPLE 

MON$* ASGN MJBtAl 

MON$$ MODE GO 

MON$$ ASGN MG0.A6 

MON*S EXEQ AUTOCODER 

Exhibit IV, Part A 
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64015 
SEQNO PGLIN LABEL 



SAMPLE PROGRAM USING 1410/7010 AUTOCODER 
OPCOO OPERAND 



PAGE I SAMPL 

REL CT ADDRS INSTRUCTION CARD FLAG 



1 


0002 




2 


0003 




3 


0004 


* 


4 


0005 


* 


5 


0006 


# 


6 


0007 


• 


7 


0008 


• 


6 


0009 


» 


9 


0010 


» 


10 


0011 


START 


11 


0012 




12 


0013 




13 


0014 


LOOP 


14 


0015 




15 


0016 




16 


0017 




17 


0018 


* 


18 


0019 


READ 


19 


0020 




20 G 


00090 




21 G 


00100 




22 G 


00110 




23 G 


00140 




24 G 


00150 




25 


0021 


RDXT 


26 


0022 


* 


27 


002 3 


CHNG 


28 


0024 




29 


0025 




30 


0026 




31 


0027 




32 


0028 




33 


0029 


CHNGX 


34 


0030 


• 


35 


0031 


PUNCH 


chibit 


IV, Part B 



TITLE RESEQUENCE 
BASEl »CX00 

THIS PROGRAM WILL RESEQUENCE SOURCE DECKS 

RENUMBERING FROM 0001 IN THE FIRST FOUR 

COLUMNS AND WITH THE IDENTIFICATION FIELD 

SUPPLIED BY THE FIRST CARD GANG-PUNCHED INTO EACH 
CARD PRODUCED. 



001 

002 



B 


READ 


MLCB 


AR80.IDENT#5 


B 


»£8 


B 


READ 


B 


CHNG 


B 


PUNCH 


B 


LOOP 



SBR RDXT65 

STDIO READ, AREA, EOF, ERROR, M 

B /RSI/ 

B EOF 

B8E ERROR, /MCS/,M 

MLNA /CRD/,»&6 

MRCG O.AREA 

B 



SBR 


CHNGXG5 


MLCA 


IDENT,AR80 


MLCA 


a a 


MLCS 


a a,AR04ti 


A 


£1,CNT#4 


MLCA 


CNT.AR04 


B 






SBR 



PCHXT&5 



7 00000 J 00054 003 

12 00007 D 00394 00306 L 003 

7 00019 J 00033 003 

7 00026 J 00054 003 

7 00033 J 00118 003 

7 00040 J 00185 004 

7 00047 J 00026 004 

7 00054 G 00116 B 004 

7 00061 J /RSI/ 004 

7 00068 J 00216 004 

12 00075 W 00259 /MCS/ M 005 

12 00087 D /CRD/ 00104 / 005 

12 00099 D 00000 00315 * 005 

7 001 11 J 00000 005 

7 00118 G 00183 B 006 

12 00125 D 00306 00394 T 006 

6 00137 D 00309 006 
12 00143 D 00309 00319 3 006 

11 00155 A 00310 00314 007 

12 00166 D 00314 00318 T 007 

7 00178 J 00000 007 

7 00185 G 00214 B 007 
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64015 
SEQNO PGLIN LABEL 



SAMPLE PROGRAM USING 1410/7010 AUTOCODER 
OPCOO OPERANO 



PAGE 2 SAMPL 

REL CT ADORS INSTRUCTION CARD FLAG 



36 


0032 




STDIO 


PUNCH .AREA 


37 r, 


00320 




BXPA 


/PCM/ 


38 G 


00330 




DCW 


#5 


39 G 


00340 




DCW 


AREA 


40 


0033 


PCHXT 


B 





41 


0034 


• 






42 


0035 


EOF 


IOCTL 


TYPE, EOJ 


43 G 


0035 


EOF 


EQU 


• 


44 G 


01510 




BZN 


•-U./CTB/ 


45 G 


01520 




BXPA 


/CNC/ 


46 G 


01530 




DCW 


EOJ 


47 G 


01580 




BZN 


•-11,/CTB/ 


48 


0036 




B 


/EOP/ 


49 


0037 


• 






50 


0038 


ERROR 


IOCTL 


TYPE, ERR 



7 00192 Y /PCH/ 

5 00203 

5 00208 00315 

7 00209 J 00000 



007 
008 
009 
009 



00216 

12 00216 V 00216 /CTB/ 2 009 

7 00228 Y /CNC/ X 009 

5 00239 00396 009 

12 00240 V 00240 /CTB/ 2 010 

7 00252 J /EOP/ 010 



64015 
SEQNO PGLIN LABEL 



SAMPLE PROGRAM USING 1410/7010 AUTOCODER 
OPCOO OPERAND 



PAGE 3 SAMPL 

REL CT ADDRS INSTRUCTION CARD FLAG 



51 


G 


0038 


ERROF 


52 


G 


01510 




53 


G 


01520 




54 


G 


01530 




55 


G 


01580 




56 




0039 




57 




0040 


» 


58 




0041 




59 






IDEN 1 


60 








61 








62 






CNT 


63 




0042 


• 


64 




0043 


AREA 


65 




0044 


AR04 


66 




0045 


AR80 


67 




0046 


• 


68 




0047 


EOJ 


69 




0048 


ERR 


70 




0049 




71 




0050 





EQU 


• 


BZN 


»-U,/CTB/ 


BXPA 


/CNC/ 


DCW 


ERR 


BZN 


*-ll,/CTB/ 


B 


/UEP/ 



DA 



#0005 

a a 
aAa 

#0004 

1X80, G 

4 

80 



DC 


3 E0J3,G 


DC 


aERRORa.G 


PST 




END 


START 



NUMBER OF FLAGGED STATEMENTS NONE 
1410/7010 AUTOCODER. ..SYSTEM /MID/ 0001 



00259 
12 00259 V 00259 /CTB/ 2 

7 00271 Y /CNC/ X 

5 00282 00402 
12 00283 V 00283 /CTB/ 2 

7 00295 J /UEP/ 

00302 

5 00306 
3 00309 
1 00310 
<► 00314 

81 00315 
00318 
00394 

6 00396 
6 00402 

00000 



010 
010 
010 
Oil 
Oil 



012 
012 
012 
012 



015 
015 
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.....C ROSS 
SAMPLE PROGRAM USING 1410/7010 AUTOCODER 



REFERENCE 



L I S T I N G»*««» 



SYMBOL 


LABEL SEQNO 


OPERAND SEQUENCE NUMBERS 


/CNC/ 




0045 0053 


/CRD/ 




0023 


/CTB/ 




0044 0047 0052 0055 


/EOP/ 




0048 


/MCS/ 




0022 


/PCH/ 




0037 


/RSI/ 




0020 


/UEP/ 




0056 


AREA 


0064 


0024 0039 


ARCH 


0065 


0030 0032 


AR80 


0066 


0011 0028 


CHNG 


0027 


0014 


CHNGX 


0033 


0027 


CNT 


0062 


0031 0032 


EOF 


0043 


0021 


EOJ 


0068 


0046 


ERR 


0069 


0054 


ERROR 


0051 


0022 


IDENT 


0059 


0011 0028 


LOOP 


0013 


0016 


PCHXT 


0040 


0035 


PUNCH 


0035 


0015 


RDXT 


0025 


0018 


READ 


0018 


0010 0013 


START 


0010 


0071 



SYMBOL 


LABEL SEQNO 


a a 


0060 


sAa 


0061 
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OPERAND SEQUENCE NUMBERS FOR LITERALS IN SEGMENT 1 
0029 0030 
0031 



MONt* EXEQ LINKLOAD 
MESSAGE CARD NAME VALUE SYMBOL VALUE SYMBOL VALUE SYMBOL VALUE 



SYMBOL VALUE 



PHASE SAMPLE 
BASE1 



18324 
18400 



TITLE RESEQUENCE 18400 REL FACTOR 18400 

UNRESOLVED ENTRIES NONE 

MON$$ EXEQ SAMPLE, MJB 
MON$t END 

Exhibit IV, Part D 

0001 AUTOCODER SAMPLE PROGRAM DECK OF DUMMY INPUT CARDS XXXXX 

0002 THIS OECK OF CARDS IS PROVIDED WITH THE SAMPLE PROBLEM TO SUPPLY A XXXXX 

0003 FEW DUMMY INPUT CARDS FOR OPERATING IN THE ASSEMBLE-AND-GO MODE. XXXXX 

0004 NOTE THAT THE FIRST CARD - THREE CARDS EARLIER IN THIS DECK - CONTA XXXXX 

0005 FIVE CHARACTERS IN CARD COLUMNS 76 THROUGH 80. AFTER EXECUTION OF XXXXX 

0006 SAMPLE PROGRAM, ALL THE CARDS PRODUCED WILL CONTAIN THESE CHARACTER XXXXX 

0007 IN THE CORRESPONDING CARD COLUMNS. NOTE ALSO THAT EACH OF THE CARD XXXXX 

0008 PRODUCED WILL CONTAIN A SEQUENCE NUMBER IN CARD COLUMNS 1 THROUGH 5 XXXXX 

Exhibit V 
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Appendix D: Autocoder Operation Codes 



This appendix contains a complete listing of Autocoder 
language statements and, where applicable, their 
machine-language equivalents. In this listing, A-ad- 
dresses in operands have been equated to location 
12345, B-addresses have been equated to location 
34567, and I-addresses have been equated to location 
56789. C- addresses (for the Store Register instruc- 
tions ) have been equated to 45678. The character "D" 
in an operand indicates that an appropriate machine- 
language d-modifier is to be coded in the Autocoder 
source statement. 

Included in the listing are several generalized forms 
for source statements. For example, the programmer 



can cause the generation of any machine-language in- 
struction with an operation code of "J" by using the 
generalized form jid i,d. Place jid in the op code field, 
and the branch address (I-address) and appropriate 
d-modifier in the operand field. The generalized forms 
permit the coding of instructions for which there are 
no specific Autocoder mnemonics. Addresses in the 
operand of the generalized forms can be specified sym- 
bolically with labels, and can have address adjustment 
and indexing. 

No diagnostics are performed on the d-modifiers as- 
sociated with generalized mnemonics. 



AUTOCODER MNEMONIC OPERATION CODES 
OPCOD OPERAND 



INSTRUCTION 



SINE/ 



PROCESSOR CONTROL OPERATIONS 
ORG 10000 ORIGIN 
LTORG * LITERAL ORIGIN 

HEADR THIS INFORMATION WILL BE THE HEACING OF LISTING 
RESEQ RESEQUENCE AT 001, NEW PAGE, NEW IDENT 

EJECT CONTINUE LISTING ON NEW PAGE 

SPEND START END PRIMARY SUBPROGRAM 
SPEND END SECONDARY SUBPROGRAM 

END START END PRIMARY SUBPROGRAM AND AUTOCODER RUN 
END END SECONDARY SUBPRGRM AND AUTOCODER RUN 

N0PWM NO OPERATION WORD MARK 

LINKAGE LOADER CONTROL OPERATIONS 
BASE1 12000 CONTROLS RELOCATION FACTOR 
BASEZ 38000 UPPER LIMIT FOR COMMON DATA AREA 

TITLE COSINE, 20,0 DECLARES NAME OF SUBPROGRAM, 
SIZE OF COMMON, ORIGIN POINT 

CEFIN COSINE+42 DECLARES LINKAGE SYMBOL 

PRTCT ABCD/ PREVENTS ERASURE OF LINKAGE SYMBOLS 
FROM LINKAGE LOADER TABLE 

CALL THIRD SUBPROGRAM CALL 
DECLARATIVE OPERATIONS 

ECU 12345 THE EQUATE INSTRUCTION 

EQU 34567 

EQb 45678 

ECU 56789 



Appendix D 59 



LABEL 



DA 


1X2, G 


OAV 


1X2, G 


DCW 




DC 


+ 2 


DS 


1 


DCWF 


NAME 


DCWS 


NAME 


RSV 


LABEL 



A 


A,B 


S 


A,B 


ZA 


A,B 


zs 


A,B 


M 


A,B 


D 


ft, 8 



AUTOCODER MNEMONIC OPERATION CODES 
OPCOD OPERAND 

DEFINE AREA 

DEFINE AREA IN COMMON AREA 

DEFINE CONSTANT WITH WORD MARK 

DEFINE CONSTANT 

DEFINE SYMBOL 

ADCON FOR ENTRY POINT OF NAMED SUBPROGRAM 

BRANCH TO NAMED SUBPROGRAM 

APPLY DOWNWARD RELOCATION TO LABEL 
ARITHMETIC OPERATIONS 

AOD A-FIELD TO B-FIELO 

SUBTRACT A FROM B 

ZERO AND ADD A TO B 

ZERO AND SUBTRACT A FROM B 

MULTIPLY 

DIVIDE 

MOVE RIGHT TO LEFT COMMANDS 
MCVE SINGLE POSITION 
MLNS A,B MOVE LEFT NUMERIC SINGLE 
MLZS A,B ZONES SINGLE 

MLCS A,B CHARACTERS SINGLE 

MLWS A,B WORD MARKS SINGLE 

MLNWS A,B NUMERIC AND WORD MARK SINGLE 

MLZWS A,e ZONE AND WORD MARK SINGLE 

MLCWS A,B CHARACTER AND WORD MARK SINGLE 

STOP MOVE AT WORD MARK IN A-FIELD 
MLNA A,B MOVE LEFT NUMERIC TO A-FIELD WORD MARK 
MLZA A,B ZONES TO A-FIELD WORD MARK 

MLCA A,B CHARACTERS TO A-FIELD WORD MARK 

MLWA A,B WORD MARKS TO A-FIELD WORD MARK 

MLNWA A,B NUMERIC AND WM TO WORD MARK IN A 

MLZWA A,B ZONES AND WM TO WORD MARK IN A 

MLCWA A,B CHARACTERS AND WM TO WORD MK IN A 

STOP MOVE AT WORD MARK IN B-FIELD 
MLNB A,B MOVE LEFT NUMERIC TO B-FIELD WORD MARK 
MLZB A,B ZONES TO B-FIELD WORD MARK 

MLCB A,B CHARACTERS TO B-FIELD WORD MARK 

MLWB A,B WORD MARKS TO B-FIELD WORD MARK 

MLNWB A,B NUMERIC AND WM TO WORD MARK IN B 

MLZWB A,B ZONES ANC WM TO WORD MARK IN B 

MLCWB A,B CHARACTERS AND WM TO WORD MK IN B 

STOP MOVE AT WORD MARK IN A- OR B-FIELD 
MLN A,B MOVE LEFT NUMERIC 
MLZ A,B ZONES 



INSTRUCTION 


3 


10001 


3 


10004 


1 


10007 


1 


10008 


1 


10009 


5 


10010 


7 


10015 



A 12345 34567 
S 12345 34567 
+ 12345 34567 

- 12345 34567 

- 12345 34567 
( 12345 34567 



D 12345 34567 1 

D 12345 34567 2 

D 12345 34567 3 

D 12345 34567 4 

D 12345 34567 5 

D 12345 34567 6 

D 12345 34567 7 

D 12345 34567 / 
D 12345 3456 7 S 
D L2345 34567 T 
D 12345 34567 U 
D 12345 34567 V 
D 12345 34567 W 
D 12345 34567 X 

D 12345 34567 J 
D 12345 34567 K 
D 12345 34567 L 
D 12345 34567 M 
D 12345 34567 N 
D 12345 34567 
D 12345 34567 P 

D 12345 34567 A 
D 12345 34567 B 
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LABEL 



AUTOCODER MNEMONIC OPERATION COOES 
OPCOD OPERAND 



INSTRUCTION 



MLC A,B 

MLW A,B 

MLNW A,B 

MLZW A,B 

MLCW A,B 



CHARACTERS 

WORD MARKS 

NUMERIC AND WORD MARKS 

ZONES AND WORD MARKS 

CHARACTERS AND WORD MARKS 



MOVE LEFT TO RIGHT COMMANDS 

STOP MOVE AT WORD MARK IN A- OR B-FIELD 



MRN 


A, fa 


MOVE 


RIGHT 


NUMERIC 


MRZ 


A,B 






ZONES 


MRC 


A,B 






CHARACTERS 


MRW 


A,B 






WORD MARKS 


MRNW 


A»B 






NUMERIC AND WORD MARKS 


MRZW 


A,B 






ZONES AND WORD MARKS 


MRCW 


A,B 






CHARACTERS AND WORD MARKS 



STOP MOVE AT RECORD MARK IN A-FIELD 

MRNR A,B MOVE RIGHT NUMERIC TO RECORD MARK IN A-FLD 

MRZR A„B ZONES TO RECORD MARK IN A-FIELD 

MRCR A,B CHARACTERS TO RECORD MARK IN A 

MRWR A,B WORD MARKS TO RECORD MARK IN A 

MRNWR A,B NUMERIC AND WM TO RM IN A-FIELD 

MRZWR A,B ZONES AND WM TO RM IN A-FIELD 

MRCWR A,B CHARACTERS AND WM TO RM IN A 

MRNG A,B MOVE RIGHT NUMERIC TO GM-WM IN A-FIELD 

MRZG A,B ZONES TO GM-WM IN A-FIELD 

MRCG A,B CHARACTERS TO GM-WM IN A-FIELD 

MRWG A,B WORD MARKS TO GM-WM IN A-FIELD 

MRNWG A,B NUMERIC AND WM TO GM-WM IN A 

MRZWG A,B ZONES AND WM TO GM-WM IN A-FIELD 

MRCWG A,B CHARACTERS AND WM TO GM-WM IN A 

STOP AT RM OR GM-WM IN A-FIELD 

MRNM A,B MOVE RIGHT NUMERIC TO RM OR GM-WM 

MRZM A,B ZONES TO RM OR GM-WM 

MRCM A,B CHARACTERS TO RM OR GM-WM 

MRWM A,B WORD MARKS TO RM OR GM-WM 

MRNWM A, 8 NUMERIC AND WM TO RM OR GM-WM 

MRZWM A,B ZONES AND WM TO RM OR GM-WM 

MRCWM A,B CHARACTERS AND WM TO RM OR GM-WM 

SCAN LEFT AND RIGHT COMMANDS 

SCNRR A,B SCAN RIGHT TO RM IN A-FIELD 

SCNRG A,B TO GM-WM IN A-FIELD 

SCNRM A,B TO RM OR GM-WM IN A-FIELD 

SCNR A,B TO WORD MARK IN A- OR B-FIELD 



D 12345 34567 C 
D 12345 34567 D 
D 12345 34567 E 
D 12345 34567 F 
D 12345 34567 G 



D 12345 34567 9 

D 12345 34567 

D 12345 34567 = 

D 12345 34567 - 

D 12345 34567 . 

G 
D 12345 34567 T 

T 
D 12345 34567 M 

D 12345 34567 Z 

D 12345 34567 t 

D 12345 34567 , 

D 12345 34567 ( 

W 

D 12345 34567 S 

D 12345 34567 

Q 
D 12345 34567 T 

D 12345 34567 R 

D 12345 34567 

D 12345 34567 $ 

D 12345 34567 » 

R 

D 12345 34567 P 

D 12345 34567 , 

D 

D 12345 34567 L 

D 12345 34567 I 
D 12345 34567 
D 12345 34567 . 

D 12345 34567 ) 
L 

D 12345 34567 P 
L 

D 12345 34567 T 
G 

D 12345 34567 M 



D 12345 34567 Y 
D 12345 34567 Q 
D 12345 34567 H 
D 12345 34567 8 
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LABEL 



AUTOCCOER MNEMONIC OPERATION CODES 
OPCOC OPERAND 



INSTRUCTION 



LL 


A,B 


LE 


A,B 


LLE 


A,B 


LH 


A,B 


LLH 


A,B 


LEH 


A, B 



SCNLA A f B SCAN LEFT TO WORD MARK IN A-FIELD 
SCNLB A,B TO WORD MARK IN B-FIELD 

SCNL A,B TO WM IN A- OR B-FIELD 

SCNLS A,B SINGLE POSITION 

SPECIAL MOVE COMMANDS 
MCS A,B MOVE CHARACTERS AND SUPPRESS ZEROS 
MCE A,B MOVE CHARACTERS AND EDIT 

COMPARE AND LOOKUP COMMANDS 
C A,B COMPARE B-FIELD TO A-FIELD 
LOOKUP LOW 
LOOKUP EQUAL 
LOOKUP LOW OR EQUAL 
LOOKUP HIGH 
LOOKUP LOW OR HIGH 
LOOKUP EQUAL OR HIGH 
LOGICAL OPERATIONS 

BRANCH TO I-ADDR IF WORD MARK AT B-ADORESS 
BRANCH TO I IF B HAS NO AB-BITS 

IF B HAS A-BIT AND B-BIT 

A-BIT AND B-BIT 
IF B HAS A-BIT AND NO B-BIT 

A-BIT AND NO B-BIT 
IF B HAS B-BIT AND NO A-BIT 

B-BIT AND NO A-BIT 
BRANCH TO I IF B HAS WM AND NO AB-BITS 
AND AB-BITS 
AND AB-BITS 
AND A-BIT 
AND A-BIT 
AND B-BIT 
ANO B-BIT 
BRANCH TO I IF CHARACTER AT B EQU D-MOD 
BRNCH IF ANY BIT AT B MATCHES BIT IN D-MOD 
UNCONDITIONAL BRANCH 
BRANCH IF COMPARE UNEQUAL 
EQUAL 
LOW 
HIGH 
BRANCH IF ZERO BALANCE 
BRANCH IF ARITHMETIC OVERFLOW 
BRANCH IF DIVIDE OVERFLOW 



BW 


tB 


BZN 


.B 


BZN 


>Bi AB 


BZN 


tB,+ 


BZN 


tB,A 




C 


BZN 


,B,T 


BZN 


iB.B 


BZN 


tB,- 


BWZ 


.B 


BWZ 


,B,AB 


BWZ 


IiB,+ 


BWZ 


»B,A 




C 


BWZ 


ItB.T 


BWZ 


,B,B 


BWZ 


I.B.- 


BCE 


tB,D 


BBE 


tB.D 



BU 

BE 

BL 

BH 

8Z 

BAV 

BDV 



D 12345 34567 T 

D 12345 34567 - 

D 12345 54567 + 

D 12345 34567 

Z 12345 34567 
E 12345 34567 

C 12345 34567 

T 12345 34567 1 

T 12345 34567 2 

T 12345 34567 3 

T 12345 34567 4 

T 12345 34567 5 

T 12345 34567 6 



V 


56789 


34567 


I 


V 


56789 


34567 


2 


V 


56789 


34567 


B 


V 


56789 


34567 


B 


V 


56789 


34567 


S 


V 


56789 


34567 


S 


V 


56789 


34567 


K 


V 


56789 


34567 


K 


V 


56789 


34567 


3 


V 


56789 


34567 


C 


V 


56789 


34567 


c 


V 


56789 


34567 


T 


V 


56789 


34567 


T 


V 


56789 


34567 


L 


V 


56789 


34567 


L 


B 


56789 


34567 





w 


56789 


34567 


D 


J 


56789 






J 


56789 




/ 


J 


56789 




S 


J 


56789 




T 


J 


56789 




U 


J 


56789 




V 


J 


56789 




z 


J 


56789 




w 
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LABEL 



AUTOCODER MNEMONIC OPERATION CODES 
OPCOD OPERAND 



INSTRUCTION 



MISCELLANEOUS OPERATIONS 

STORE A-REGISTER 

STORE 6-REGISTER 

SET WORD MARK AT A 

SET WORD MARK AT A AND B 

CLEAR WORCMARK AT A 

CLEAR WORD MARK AT A AND B 

CLEAR STORAGE 

CLEAR STORAGE AND BRANCH 

NO OPERATION 

STORE TIME CLOCK 

GENERALIZED STORE REGISTER 
STORE CPU STATUS 
RESTORE CPU STATUS 
FLOATING POINT ARITHMETIC INSTRUCTIONS 
FLOATING RESET ADD 
FLOATING STORE 
FLOATING ADD 
FLOATING SUBTRACT 
FLOATING MULTIPLY 
FLOATING DIVIDE 
BRANCH EXPONENT OVERFLOW 
BRANCH EXPONENT UNDERFLOW 



SAR 


C 




SBR 


C 




sw 


A 




sw 


A, 


iB 


cw 


A 




cw 


A, 


,B 


cs 


B 




cs 


Ii 


,B 


NOP 






STC 


A 




SR 


C, 


,D 


STCPU 


I 




RSCPU 


I 





FRA 


A 


FST 


A 


FA 


A 


FS 


A 


FM 


A 


FD 


A 


BXO 


I 


BXU 


I 



G 45678 A 

G 45678 B 

, 12345 

, 12345 34567 

) 12345 

) 12345 34567 

/ 34567 

/ 56789 34567 

N 

G 12345 T 

G 45673 D 

$ 56789 S 

$ 56789 R 



= 


12345 


R 


= 


12345 


L 


= 


12345 


A 


= 


12345 


S 


= 


12345 


M 


= 


12345 


D 


J 


56789 


Y 


J 


56789 


X 



NOTE: The remainder of this listing presents in- 
structions that are (or can be) related to input/output 
functions, including the use of priority and overlap. 
They are "restricted" in that special care must be 
given to their use, since they are potential hazards 
to such Resident Monitor control functions as input/ 
output scheduling and assignment of input/output units. 
Because all programs within the Operating System 
are provided with input/output facilities by the 



system's IOCS, the majority of these instructions will 
not normally be used in coding an Autocoder program. 
The programmer who wishes to use any of these in- 
structions is advised to be familiar with the extended 
use of the IOCS, as explained in the publication IBM 
1410/7010 Operating System: Basic Input/Output 
Control System , Form C28-0322. 



CONDITIONAL BRANCHES FOR I/O. OVERLAP, AND PRIORITY 
BRANCH EXTERNAL INDICATOR - CHANNEL 1 

- CHANNEL 2 

- CHANNEL 3 

- CHANNEL 4 



BEXl 


ItD 


BEX2 


ItD 


BEX 3 


1,0 


BEX4 


1,0 



R 


56789 


D 


X 


56789 


D 


3 


56789 


D 


1 


56789 


D 



NOTE: The Branch External Indicator instructions 
must not be used in any form, for any purpose, by 
dependent programs within the Operating System. 
These instructions reset certain interrupt indicators 



and can result in either an I/O interlock error or 
failure of IOCS functions. The BEX mnemonic is 
included in this listing merely as an aid for reading 
assembly listings of the Resident IOCS. 



BOL1 


I 


BOL2 


I 


B0L3 


I 


B0L4 


1 


BB1 


I! 


BB2 


I 



BRANCH OVERLAP IN PROCESS - CHANNEL 1 

- CHANNEL 2 

- CHANNEL 3 

- CHANNEL 4 
BRANCH IF BINARY CARD - CHANNEL 1 

- CHANNEL 2 



J 56789 


I 


J 56789 


2 


J 56789 


3 


J 56789 


4 


J 56789 


M 


J 56789 


I 
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LABEL 



AUTOCODER MNEMONIC OPERATION COOES 
OPCOO OPERAND 



INSTRUCTION 



BRANCH PRINTER CARRIAGE BUSY - CHANNEL 1 

- CHANNEL 1 

- CHANNEL 2 
BRANCH CARRIAGE OVERFLOW - CHANNEL 1 

- CHANNEL 1 

- CHANNEL 2 
BRANCH CARRIAGE CHANNEL 9 - CHANNEL 1 

- CHANNEL I 

- CHANNEL 2 
BRANCH AND EXIT PRIORITY ALERT 
BRANCH AND ENTER PRIORITY ALERT 

JID 1,0 GENERALIZED TEST AND BRANCH 

THE ABOVE IS A GENERALIZED FORM, PERTAINING TO 
THE J OPCODE. THE PROPER D MODIFIER MUST BE 
SUBSTITUTED BY THE USER FOR THE D SHOWN IN THE OPERAND 

BPI 1,0 GENERALIZED PRIORITY TEST AND BRANCH 
THE ABOVE IS A GENERALIZED FORM, PERTAINING TO 
THE Y OPCODE. THE PROPER D MODIFIER MUST BE 
SUBSTITUTED BY THE USER FOR THE D SHOWN IN THE OPERAND 



B 


I 


BPCB1 


I 


BPCB2 


I 


BCV 


I 


BCVl 


I 


BCV2 


I 


BC9 


I 


BC91 


I 


BC92 


I 


BXPA 


I 


BEPA 


I 



J 56789 


R 


J 56789 


R 


J 56789 


L 


J 56789 


- 


J 56789 


- 


J 56789 


) 


J 56789 


9 


J 56789 


9 


J 56789 





Y 56789 


X 


Y 56789 


E 



NOTE: The Priority Test and Branch instructions 
reset indicators tested by the Resident IOCS and, 
therefore, should be used with special care. A 



thorough knowledge of the internal functions of the 
IOCS is prerequisite for use of these instructions in 
a dependent program . 



STATS 1,0 GENERALIZED STORE ANO RESTORE STATUS 
THE ABOVE IS A GENERALIZED FORM. THE PROPER 
D MODIFIER MUST BE SUBSTITUTED FOR THE D SHOWN. 
FOUR EXAMPLES OF THIS USAGE ARE 

STORE CHANNEL 1 STATUS 
STORE CHANNEL 3 STATUS 
RESTORE CHANNEL 1 STATUS 
RESTORE CHANNEL 4 STATUS 
SELECT STACKER ANO FEED - CHANNEL 1 
CARRIAGE CONTROL I/O CHANNEL 1 
BACKSPACE TAPE 
WRITE TAPE MARK 
REWIND 

REWIND AND UNLOAD 
CONTROL UNIT 
(Bl.B.D TO BUILD MOVE MODE I/O COMMAND 
(Bl.B.D TO BUILD LOAD MODE I/O COMMAND 



$ 56789 



STATS 


I.E 




STATS 


I,G 




STATS 


1,1 




STATS 


I, A 




SSF 







CC 


1 




BSP 


(Bl 




WTM 


(Bl 




RWD 


(Bl 




RWU 


(Bl 




CU 


(Bl, 


iW 


MU 


(Bl, 


B 


LU 


(Bl, 


B 



$ 


56789 




E 


$ 


56789 




G 


% 


56789 




1 


% 


56789 




4 


K 









F 






1 


U 


(Bl 




B 


U 


(Bl 




M 


u 


(Bl 




R 


u 


(Bl 




U 


u 


(Bl 




W 


M 


(Bl 


34567 





L 


(Bl 


34567 


D 



I HALT AND BRANCH . 56789 

machine halts. This convention is especially signifi- 
cant for dependent programs that run under control 
of a Resident Monitor that includes the Tele-process- 
ing Supervisor. 



NOTE: The Halt instruction, although not necessarily 
related to input/output functions , is included in the 
"restricted" category because its use is in opposition 
to the Operating System convention that dependent 
programs should not interrupt Monitor control with 
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ENO 



Index 



Absolute Adjustment 9 

Absolute P'ormat 7, 19 

Address Adjustment 15 

Adjustment Factor 15 

The Form *+X00 16 

Multiple Adjustment 16 

Address Constant (Definition) 18 

addrs ( Address ) 11 

Alphameric Constant 28 

Alphameric Literal 18 

Area Defining Literal 18 

Assembly Control Statements 35 

Assembly Listing 10 

Asterisk Address ( Types ) 15 

Asterisk plus X00 16, 33, 37 

Autocoder 5 

Language 5 

Operation Codes 5, 7, 21 

Processor 5 

Statements 7 

basei — Base Address 33 

Actual 33 

Asterisk plus X00 33 

Symbolic 33 

BASE2 — Base Address ( common Data Area ) 33 

Basic Addresses 14 

Actual 15 

Asterisk 14 

Symbolic 14 

Blank Operation Field 23, 29 

Blank Operand 20 

bool (Pseudo-Macro) 46 

call — Subprogram Call 33 

card ( Card Number) 11 

Coding Sheet 12 

comments and comments card 12 

common ( Definition ) 8 

Assignment of Data Areas 26 

Restriction 26 

Use of Labels 27 

comp (Pseudo Macro) 47 

Control Operation Codes 35 

Assembly 35 

Subprogram 36 

Control Statements (Definition) 35 

Cross Reference Listing 36* 11 

ct (Character Count) 11 

da — Define Area 23 

Statement 23, 24 

Subentries 23 

Parameters 24 

Sample Problem 25 

Review 25 

dav — Define Area in common 26 

The common Data Area 26 

Coding Examples 35, 36 

dc — Define Constant 30 

dcw — Define Constant with Word Mark 27 

Address Constant 29 

Alphameric 28 

Blank 29 

Implied dcw 29 

Numeric 28 

Signed Address Constant 29 



dcwf — Subprogram Address Constant 33 

dcws — Subprogram Branch Instruction 34 

Declarative Operation Codes 23 

Declarative Statements 23 

defin — Definition 34 

Downward Relocation 8 

ds — Define Symbol 30 

eject — Eject 35 

end — End Subprogram and Assembly 38 

equ — Equate 30 

Actual or Symbolic Address 30 

Adjusted or Modified Address 30 

Index Register 31 

Asterisk 31 

exeq Card 9 

Flags ( Definition ) 11 

Assembly Listing 11 

Causes 11, 51 

Diagnostics 51 

Types 11 

Group Mark Word Mark 24, 28 

da Statement 24 

dcw Statement 28 

Heading Lines (Assembly Listing) 10 

headr — Header Line 10, 35 

Identification, Program 10, 35 

Imperative Operation Codes 21 

Imperative Statements (Definition) 7 

Symbolic Machine Instructions 21 

Special Imperative Statements 21 

Indexing (Definition) 16 

Addressing an Index Register 16 

Addresses 16 

With Address Adjustment 17 

instruction (Assembly Listing) 11 

Label (Definition) 7 

As Address Constant 18 

Assembly Listing 11 

As Symbolic Address 14 

Coding Form 12 

Labeling ( Definition ) 7 

common 26 

equ Statement 30 

Index Register 31 

Macros 42 

org Statement 38 

Linkage Loader Statements 7 

Functions 32 

Operation Codes 32 

Linkage Symbols (Definition) 19 

Conventional Label 19 

The Form labe/ 19 

Literals 17 

Address Constant 18 

Alphameric 18 

Area Defining 18 

Numeric 17 

Load Address 37 

Long Literal (Definition) 17 

Numeric 17 

Alphameric 18 

ltorg — Literal Origin 38 



Index 65 



Machine Instructions 21 

Assembly Listing 11 

Machine Language 11, 59 

Symbolic 21 

Machine Requirements 6 

Library, Macro 40 

Macro Operations 40 

Macro Routine 40 

Macro Processing 50 

Macro System 40 

math (Pseudo-Macro) 44 

mend ( Pseudo-Macro ) 48 

Mnemonic Operation Codes 11, 22, 59 

Multiple Compilation 9 

mon$$ exeq Card 9 

Option Card 9 

No Clear Option (DA Statement) 25 

no Relocation 8 

nop — No Operation 21 

nopwm — No Operation; Word Mark 21 

note (Pseudo-Macro) 48 

Assembly Listing 11 

Flag 11,51 

Numeric Constants 28 

Numeric Literal 17 

Object Deck ( Definition ) 5 

Object Program ( Definition ) 5 

opcod ( Operation Code ) 11 

Operand (Definition) 7 

Assembly Listing 11 

Types of Operands 14 

Operand Entries 14 

Adjustment Factors 15 

Basic Addresses 14 

d-Characters 20 

Index Notations 16 

Parameters (da and dav) 24 

Special Elements 20 

Operating System 5 

Operation Code ( Definition ) 7 

Assembly Listing 11 

Coding Sheet Form 12 

Machine Language Instruction 11, 59 

Operation Modifier ( d-Character ) 7, 20, 51 

Option Card 9 

Options, Processing 9 

org — Origin 36 

Origin Address 36 

Actual 37 

Asterisk 37 

Asterisk +X00 37 

Blank 37 

Symbolic 37 

Overriding Indexing 24 

Page-and-Line Number 11 

Parameters 24, 26, 32 

da and dav Statements 24 

title Card 32 

pglin (Page-and-Line Number) 11 

Predefined Symbols 16 

common 26 

X0 27,17 

X1-X15 16 



Prerequisites 5 

Processing Options 9 

Processor, Autocoder 5 

Program Execution ( Assembly ) 9, 53 

prtct — Protect 34 

Pseudo-Macro Instructions 43 

Coding Examples 49 

pst — Print Symbol Table 35 

Reference Address ( Basic Address ) 14 

rel (Relocation Indicator) 11 

| Relocation 8, 36 

Downward 8 

no 8 

Upward » 8 

Replacement Codes (Definition) 11 

Representations 12 

resq — Resequence 35 

Restrictions 

Area Defining Liberal 18 

| COMMON 8 

dcw ( Blank Constants ) 29 

Operation Codes 22, 59, 63 

X13 17 

X14 and X15 17 

rsv — Reserve 27 

Sample Program 53 

seqno ( Sequence Number) 11 

Sequence Number 11, 35 

spend — Subprogram End 38 

Statements, Autocoder (Definitions) 7 

Subprogram (Definition) 5 

Control Statements 36 

Primary 39 

Secondary 39 

Sum Box 44 

Symbol (Definition) 7 

Symbolic Address 14 

Symbolic Machine Instructions 21 

System Symbol (Definition) 20 

/ams/ 9, 26 

/dat/ 10 

/eop/ 9 

/lin/ 11 

/uep/ 9 

Termination, Object Program 9 

title - Title 32 

Entries 32 

Format 32 

Types of Operands 14 

Address Adjustment 15 

Basic Address 14 

Indexing 16 

Linkage Symbols 19 

Literals 17 

Miscellaneous 20 

System Symbols 20 

Upward Relocation (Definition) 8 

X0 (Index Negation) 24 

X1-X15 (Predefined Symbols) 16 

X13 ( Considerations ) 17 

X14-X15 (Restrictions) 17 

Zero Addressing, Relative to 25 

Zero Operand 20 



66 




Technical Newsletter 



File Number 

Re: Form No. 

This Newsletter No. 

Date 



1410/7010-22 

C28-0326-2 

N27-1223 

June 24, 1965 



Previous Newsletter Nos. 



None 



IBM 1410/7010 AUTOCODER 

This Technical Newsletter amends the publication IBM 1410/7010 Operating System ; 
Autocoder , Form C28-0326-2, to include new information concerning the DCW statement, 
the chaining of instructions and the use of zoned switches, and to correct minor errors. 

The attached replacement pages (11-14, 29-30, and 41-42) should be substituted for the 
pages currently in the publication. Text changes are indicated by a vertical line at the 
left of the affected text. 

In addition, the following changes should be made to the publication: 

Page Amendment 

22 Change the Meaning of the mnemonic "HEADR" (under "Assembly 

Control Codes") to read 

Header Line 

26 Under the heading "Assignment of Data Areas in COMMON", the 
first paragraph refers to "Figures 61 and 62". Change this refer- 
ence to read: 

Figures 35 and 36 

27 In the section "Use of Labels Referencing COMMON," there are two 
references to "Figure 61". Change these references to read: 

Figure 35 

47 The first complete sentence on the page ends with "skip to state- 

ment 004". Change this to read: 

skip to the statment labeled L. 

51 The second sentence in Note 2 ends with the word "common". The 

word "common" should be capitalized to read: 

COMMON 

Please file this cover letter at the back of the publication. It provides a method of de- 
termining that all changes have been received and incorporated into the publication. 



IBM Corporation, Programming Systems Publications, Dept. 637, Neighborhood Road, Kingston, N.Y. 12401 

N27-1223 (C28-0326-2) Page 1 of 1 



PRINTED IN U.S.A. 



1. SEQNO — Sequence Number: The sequence 
number of statements as they appear in the assembly 
listing. 

2. PGLIN — Page and Line Number: The page and 
line number as it appears in columns 1 through 5 of 
the cards in the source deck. Page and line numbers 
must consist of five non-blank characters and must ap- 
pear in ascending sequence. 

Statements generated by the macro generator will 
have a page and line number in this field supplied by 
the generator. These numbers have no relationship to 
the numbers of the hand-coded statements; they rep- 
resent the order in which the statements appear in the 
Macro Library. 

The space between the seqno and pglin columns of 
the listing are used by the processor to contain either 
an "S" or a "G," under the following conditions. 

S — The page and line number of the statement is 
not in ascending sequence in. relation to the preceding 
source statement. This is only a warning to the pro- 
grammer that his source statements may be out of 
sequence. 

G — This character differentiates statements pro- 
duced by the macro generator from the hand-coded 
source statements. 

3. LABEL — Label: The contents of the label field, 
columns 6 through 15, of the Autocoder statement. 

4. OPCOD: The Operation Code, columns 16 
through 20, of the Autocoder statement. 

5. OPERAND: The contents of the operand field, 
columns 21 through 72, of the Autocoder statement. 

6. REL — Relocation Indicator: This is a code char- 
acter that indicates to the Linkage Loader the type 
of relocation to be applied to the element(s) in the 
statement. 

7. CT — Character Count: The length in characters 
of the assembled imperative statement, or the number 
of core-storage locations reserved for a constant de- 
fined in a declarative statement. 

8. ADDRS: The relative address assigned by the 
processor to the instruction or constant. This address 
is subject to relocation. 

9. INSTRUCTION: The assembled machine-lan- 
guage instruction or constants from which the object 
deck is constructed. 

10. CARD — Card Number: The sequence number 
of the card in which the associated constants or in- 
structions appear in the object deck. This sequence 
number is automatically computed and placed in col- 
umns 73-75 of each card in the object deck, in ascend- 
ing order. 



11. FLAG: An alphabetic character indicating an 
actual or possible programming error. As many as five 
flags can be assigned to one Autocoder statement. The 
flags provided are as follows: 

F — invalid statement Format 

M — Multiple definition of a label 

N — macro generation Note 

O — invalid Operation code 

R — Restricted operation code ( if not generated 
by a macro ) 

U — Unidentified label in the operand 

W — Warning, general classification of error 

Details concerning the above flags can be found in 
Appendix A. The total number of flagged statements 
is indicated at the end of the assembly listing, followed 
by a line which contains the sequence number of each 
flagged statement, to a maximum of 20 numbers. The 
presence of any flag except "R" causes the processor 
to set the "no-go" switch during assembly. This setting 
of the "no-go" switch can cause a bypassing of all the 
source cards up to the next job. See the System Monitor 
publication. 

The assembly listing can be supplemented by a cross 
reference listing at the option of the user, by means 
of the pst statement. This listing analyzes the sub- 
program^) just assembled, and lists each label, fol- 
lowed by the sequence number of the statement in 
which it was defined, and the sequence number of 
each statement in which the label is used as a reference 
address. See "pst — Print Symbol Table," in the sub- 
section "Control Operation Codes," for a more detailed 
explanation. 

Note: The system symbol /lin/ controls the line 
count on the listing page. However, if this system sym- 
bol calls for the printing of less than 30 lines per page 
the processor will reject this direction and print the 
assembly listing at the normal 55 lines per page. See 
the System Monitor publication for details concerning 
this system symbol. 



Replacement Codes 

The Autocoder processor utilizes a second line (nor- 
mally blank ) in the assembly listing, for the representa- 
tion of non-printable characters. Each of these char- 
acters is represented by two characters, one printed 
above the other, at the appropriate place in the listing. 
These two-character substitutions are called replace- 
ment codes, and they appear most frequently as re- 
location indicators or operation modifiers. 
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The two-character replacement codes with their con- 
ventional graphic representations, card codes, and 
names are listed in Figure 3. 



Replacement 
Code 


Graphic 


Card 
Code 


Name 


ft 


? 


12-0 


Plus Zero 


6 


! 


11-0 


Minus Zero 


G 

M 


t 


12-7-8 


Group Mark 


Q 
T 


+4+ 


0-7-8 


Segment Mark 


W 

s 


ry~^ 


0-5-8 


Word Separator 


D 
L 


A 


1 1 -7-8 


Delta 


C 
T 


C or ,6 


2-8 


Cent Sign or Substitute Blank 


L 
P 


[ 


12-5-8 


Left Bracket 


R 
P 


] 


11-5-8 


Right Bracket 


T 

M 


^~ 


7-8 


Tape Mark 


L 
T 


< 


12-6-8 


Less Than 


G 

T 


> 


6-8 


Greater Than 


; 


; 


11-6-8 


Semicolon 






5-8 


Colon 


b 


\ 


0-6-8 


Backslash 



Figure 3. Replacement Codes 



Coding Sheet 

The Autocoder Coding Sheet (Figure 4) provides a 
convenient form for coding source program statements. 
Column numbers on the coding sheet have a one-for- 
one correspondence to the columns on the card used to 
punch the source statements (Autocoder Input Card, 
FormA36199). 

Each line of the coding sheet is punched into a sepa- 
rate card. The source deck, therefore, consists of a 
sequenced set of punched cards containing a line-by- 
line representation of the coding sheets. 

The following paragraphs explain the function of 
each field. The heading information, Program, Pro- 
grammed By, and Date, are only for documentation, 
and are not punched. 



Identification (Card Columns 76-80) 

This five-position field can contain a name created by 
the programmer to identify the program. This identi- 
fication will be punched into 76-80 of the object deck 
only if it appears in a headr or reseq control card. ( See 
"Control Operation Codes.") However, the identifica- 
tion is not checked on the other Autocoder statements, 
and serves only to identify the program to which the 
card belongs. Special, as well as alphameric, characters 
are permitted. 

Page Number and Line Number (Card Columns 1-5) 
The page number (columns 1 and 2), in conjunction 
with the line number (columns 3-5), provides a means 
of sequencing the cards in the source deck. This enables 
the programmer to identify and correlate the entries 
on the coding sheet and assembly listing with the 
entries in the source deck. Alphabetic, as well as nu- 
meric, characters can be used. ( If the standard collat- 
ing sequence is not followed, the processor will place 
a sequence (S) flag next to the pglin field in the as- 
sembly listing, as previously explained. ) 

Label (Card Columns 6-15) 

This field, if used, contains the label being defined in 
this statement. 

Operation Code (Card Columns 16-20) 

This field contains the operation code. 

Operand (Card Columns 21-72) 

This field, if used, contains the operand element(s) of 
the statement. 

Note: Columns 73-75 should be left blank. 

COMMENTS 

Comments are remarks or notes written by the pro- 
grammer in the operand field. At least two blank spaces 
must separate a comment from the last character of 
the statement. The comment, punched in the source 
deck, appears in the assembly listing but is not con- 
tained in the object deck, and has no effect on the 
object program. 

COMMENTS CARD 

It may, at times, be helpful to insert an entire line of 
descriptive information. This is done by placing an 
asterisk in column 6 and using the balance of the line 
(up to column 72) for comments. When this line of 
information is punched into a card of the source deck, 
the asterisk will identify it to the processor as a com- 
ments card. The comments will be printed in a single 
line of the assembly listing at the point of encounter, 
which can be anywhere in the source deck, except as 
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Date 
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Figure 4. The Coding Sheet Form 



noted under "Implied dcw Operation Codes." Com- 
ments cards have no effect on the object program and 
are not included in the object deck. However, a com- 
ments card inserted in a series of chained Autocoder 
operation codes will break the chain. It is, therefore, 



necessary to restate the operation code and to provide 
the proper operand on the first source card statement 
following the comments card, in order to resume a 
chained action. In summary, a chain which is broken 
by a comment must be made into two chains. 
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Types of Operand Entries 



This section explains the form and use of the various 
entries permitted in the operand field of imperative, 
declarative, Linkage Loader, and control statements. 
The operand field of an Autocoder statement is used 
to specify a variety of information to the processor. 
The function of a specific entry is dependent upon the 
type of Autocoder statement in which it appears. The 
normal operand usage with each of the five types of 
Autocoder statements is as follows. 



STATEMENT TYPE 

IMPERATIVE 



DECLARATIVE 



LINKAGE LOADER 



CONTROL 



MACRO 



OPERAND CONTENTS 

Symbolic address(es) to be operated 
upon by the machine instruction, and 
a d-modifier, when required 
Constants, symbols, and/or control 
parameters necessary to declare the 
desired fields 

Symbolic ( or actual ) addresses and/or 
control parameters required to convert 
the object deck into absolute format 
Symbolic (or actual) addresses and 
constant information indicated by the 
operation code 

Parameters of the macro statement 
(These parameters are discussed in 
the section entitled, "The Macro Sys- 
tem." ) 

All permissible operand entries are explained and 
illustrated under the following headings: 
Basic Addresses 
Address Adjustment 
Indexing 
Literals 

Linkage Symbols 
System Symbols 
Miscellaneous 



Basic Addresses 

Basic addresses contained in the operand field of an 
Autocoder statement are the primary elements of 
information conveyed to the processor. They can be 
altered or modified by means of additional elements 
contained in the operand field. 

A basic address is the symbolic or actual representa- 
tion of a core-storage location of the data, field or in- 
struction referred to by the Autocoder statement. 
A basic address can be in one of three forms: 

Symbolic 

Asterisk 

Actual 



Symbolic 

A symbolic address is an operand entry that appears 
elsewhere in the source program as a label. As a rule, 
this symbol can be defined as a label either before or 
after the Autocoder statement in which it appears as 
an address. The exceptions to this rule are as follows: 

1. All symbolic operands appearing in org, ltorg, 
and equ statements must have been previously defined 
within the same program. 

2. The symbolic address appearing in an rsv state- 
ment must precede any other use of this symbol in a 
program. ( See "rsv — Reserve." ) 

3. The symbolic representations of index registers 
(XO, X1-X15) and the common data area (common), 
must never appear in the label field. They cannot be 
defined by the user because they are predefined labels 
in the symbol table maintained by the Autocoder proc- 
essor. 

The instruction in Figure 5 illustrates the use of 
symbolic addresses. The symbols total and accumu- 
late are defined as labels elsewhere in the program. 
The assembled instruction will cause the contents of 
the core-storage area labeled total to be moved to the 
area labeled accumulate. 

Note: A symbolic address will receive upward, 
downward, or no relocation, depending on the manner 
in which the symbol is defined. 
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, ■ , ■ i i , , , 







Figure 5. Autocoder Instruction with Symbolic Addresses 



Asterisk (*) 

An asterisk (11-4-8 punch) can be used as a basic ad- 
dress in an Autocoder statement. When compiling the 
object program, the processor will replace the asterisk 
with the relative core-storage address of the last char- 
acter of the instruction or data field created by the 
statement in which it appears. However, if an asterisk 
address is used in a statement that does not cause the 
generation of an instruction or data area in the object 
program, the value substituted for the asterisk will be 
the current location in the object program. 
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Blank Constants 

A field of blanks can be reserved by placing a # char- 
acter (3-8 punch) in column 21, followed by a number 
indicating how many consecutive blank core-storage 
positions are to be defined (Figure 40). A word mark 
is set in the high-order position of this field. 

Note: The number of successive blank constants 
that can be reserved by a dcw statement is limited to 
500 positions of core storage. If this limit is exceeded, 
the processor will reserve only the maximum (500 
positions), and attach an "F" flag to the statement on 
the assembly listing. 
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a storage location. In Figure 42, manno ( actual address 
00500) has been address adjusted by +12. Thus, the 
location labeled fica will contain the address constant 
00512. 



Line 
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Label 
6 15 


Operation 

16 20 


21 25 30 35 40 < 


0,1, 


fi.ca. . ! . . . 


I>,C.W. 


AIA/V./Va+,i,2 ( 


0,2 


1 
1 1 I 1 
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Figure 42. Address Constant with Address Adjustment Defined 
in dcw Statement 
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Figure 40. Field of 14 Blanks Defined in a dcw Statement 



Address Constants 

A dcw statement can be used to define an address 
constant. The constant is the address of the field whose 
label is written in the operand. For example (Figure 
41), assume that the label manno is used in the sym- 
bolic program, and that it was assigned the address 
00500 by the processor. The programmer can refer to 
the address of manno by using the symbolic label of 
the dcw statement. 
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Figure 41. Address Constant 



The five-character data field labeled serial ( Figure 
41) will contain the address of the label manno 
(00500). The Linkage Loader will recognize address 
constants and adjust them by the proper relocation 
factor. Thus, serial will contain the relocated address 
of manno. 

If an address constant is address adjusted in a dcw 
statement, the constant is adjusted before it is assigned 



Address constants defined in a dcw statement can 
be indexed. The zone bit(s) indicating the specified 
index register becomes part of the constant. 

Note 1: All address constants receive the same relo- 
cation indicators that were assigned to the symbol 
specified in the operand field. 

Note 2: An address constant of a linkage or system 
symbol can be specified, and the desired address will 
be automatically supplied by the Linkage Loader. 
However, this form of address constant cannot be 
address adjusted or indexed. 



Signed Address Constants 

An address constant defined in a dcw statement can be 
signed. A and B bits will be generated by the processor 
over the units position, if the plus ( + ) sign was placed 
before the operand. The units position will contain a 
B bit if the minus ( — ) sign was used ( Figure 43 ) . 
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Q2 iF.EDTAXl , , , \P,CW, , \-W;LT ,H.O.Lli.TMG, 



+MA.M .U.O. 



Figure 43. Signed Address Constants Defined in dcw Statement 

Implied DCW Operation Codes 

If several constants are to be defined in succession, only 
the first statement (or any statement preceded by a 
comments card) requires the mnemonic dcw in the 
operation field ( Figure 44 ) . 
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10 .... . . 
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Figure 44. Successive dcw Statements with Blank Operation Columns 
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DC — Define Constant (no word mark) 

The function performed by the dc statement, and the 
permissible forms of the constants, are identical to 
those described for the dcw statement. The only differ- 
ence is that the word mark is absent when the constant 
is assigned to core storage ( Figure 45 ) . 
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Figure 45. Successive dc Statements with Blank Operation 
Columns 



Note: The restriction on the use of an initial word 
separator character in the dcw statement defining an 
alphameric constant does not apply to the dc statement. 



DS — Define Symbol 

The ds statement is used to label and define an area 
within the subprogram. No information is entered into 
the area, no word mark is assigned by the processor, 
and the area is not cleared prior to reservation. The 
programmer specifies the size of the area, and desig- 
nates the symbolic label by which it will be referenced. 
The number of desired consecutive positions of core 
storage is written in the operand field ( Figure 46 ) . The 
label refers to the low-order position of the area. 
However, if the label is indented one place, that is, 
if it begins in column 7, the label will refer to the high- 
order position. A label is not mandatory. 




resentation of the location to be "equated" is specified 
in the operand field. 

An equ statement can be used to assign a symbolic 
label to each of the following: 

Actual or symbolic address 

Adjusted or modified address 

Index register 

Asterisk address 

Actual or Symbolic Address 

The symbol to be defined is specified in the label field. 
The operand field can contain an actual or symbolic 
address. If a symbolic address is specified in the op- 
erand field, it must have appeared as a label prior to 
this point in the subprogram. If this condition is not 
met, the label will not be defined. 

SYMBOLIC ADDRESS 

The equ statement in Figure 47 will cause the processor 
to assign the same address to the label individual 
that is assigned to the symbol manno. Thus, individual 
has been equated to manno — both labels refer to the 
same core-storage location and are assigned the same 
relocation indicator by the processor. 
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Figure 46. Defining Twelve-Position and Five-Position Areas in 
ds Statements 



Figure 47. Equating a Symbolic Address 



ACTUAL ADDRESS 

The equ statement in Figure 48 will cause the processor 
to assign the label acctno to machine location 25000. 

Note: Labels equated to actual addresses will be 
treated as absolute values and given a no relocation 
indicator. 



Figure 46 illustrates the form of the ds statement. 
The first entry, labeled dozen, defines an area twelve 
positions long. The second entry, labeled five, defines 
an area five positions in length. 
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Figure 48. Equating an Actual Address 



EQU — Equate 

The equ statement is used to define either a second 
symbol to reference a specific location, or a symbol 
for a location not previously labeled. The symbol to 
be defined is specified in the label field, and the rep- 



Adjusted or Modified Address 

The operand of an equ statement can be address ad- 
justed or indexed. The same relocation indicators 
assigned to the address adjusted and/or indexed op- 
erand will be given to the defined label. 
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Figure 78. ibm 1410/7010 Library Coding Form 
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Figure 79. Macro Operations 
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Operation 
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Figure 80. Model Statement for a Complete Instruction 



that a corresponding parameter from the macro- 
instruction operand field must be inserted in its 
place. This code is a □ followed by a number 
from 001 to 199, that indicates the position of 
the parameter in the macro-instruction. The 
macro-instruction in the source program will 
give the parameter entries to be inserted in the 
object routine. The model statement is illus- 
trated in Figure 81. 
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Figure 81. Model Statement for an Incomplete Instruction with 
Required Parameters 

c. If the entry is incomplete, the programmer 
writes a □ followed by a number from 001 to 199 
with ab bits over the units position ( parameter 
001 is nOOA, parameter 2 is nOOB, etc.). This 
indicates that the entry is to be included in the 
object routine only if the parameter is specified 
by the macro-instruction. For example, if pa- 
rameter 003 does not appear in the macro- 
instruction, the instruction shown in Figure 82 
will be deleted from the object routine. 
Note: If parentheses are used, the programmer can- 
not use zoned switches in a math or bool statement. 
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Figure 82. Model Statement for an Incomplete Instruction with 
Conditional Parameters 

Labeling: If the model statement represents an in- 
struction entry point for a branch instruction elsewhere 
in the program, it should have a label. 

If additional external labels are required and speci- 
fied as parameters in the macro-instruction they can 
be inserted in the label field of the symbolic program 
entry by using the n001-199 code. 

The label of the macro-instruction causes the genera- 
tion of an equate statement in the assembled object 
routine. The label is equated to an *, as shown in 
Figure 83. 



Another example is shown in Figure 84. 

Symbolic Addressing within the Library Routine: 
To allow a symbolic reference to other instructions in a 
library routine a □ followed by a number from 001 to 
199 with a B bit over the units position (nOOJ = sym- 
bolic address 1, nOOK = symbolic address 2, etc. ) can 
be used. For example, the processor generates the sym- 
bolic address if the code dOOJ is used as a label for one 
entry and as an operand of at least one other entry in 
the same library routine. 

Internal labels within flexible routines are generated 
in the form Onnnmmm, where nnn is the code (00J- 
09R), and mmm is the number of the macro within 
the source program. This is done to avoid duplicate 
address assignments for labels. 

Example: Use the generated symbolic address of 
□00J as an operand for entry 3 and as the label for 
entry 6. updat is the 23d macro encountered in the 
source program ( Figure 85 ) . 

Address Adjustment and Indexing: The parameters 
in a macro-instruction and the operands in partially 
complete instructions in a library routine can have 
address adjustment and indexing. 

If address adjustment is used in both the parameter 
and the instruction, the assembled instruction will be 
adjusted to the algebraic sum of the two. For example, 
if the address adjustment on one is +7 and the other 
is — 4, the assembled instruction will have address 
adjustment equal to +3. 

Model statement operands can be indexed. This in- 
dexing takes precedence over any indexing of a param- 
eter supplied by a macro-instruction. The model state- 
ment index is used. 

Literals: Operands of instructions in library routines 
may use literals as required. However, these literals 
may not contain the @ symbol within an alphameric 
literal. 
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as the reference address of common during the assem- 
bly process. All relocatable addresses of data in com- 
mon are relative to 99999. For example, the 15th lo- 
cation downward in common is assigned the value 
99985, and appears as the same relative address in all 
subprograms. Labels referencing common are assigned 
downward relocation indicators for absolute adjust- 
ment by the Linkage Loader. 

Absolute adjustment involves changing the relative 
values of the labels (assigned to them by the proc- 
essor ) to absolute values in the relocated common data 
area. The adjustment factor applied is the difference 
between the value of common in the assembly process 
( 99999 ) and the absolute value of common determined 
by the Linkage Loader. Normally, the Linkage Loader 
will place common at the location represented by the 
value of the system symbol /ams/ ( Absolute Memory 
Size). However, the programmer can specify a dif- 
ferent absolute location for common by means of a 
base2 statement. (The interested reader will find a 
fuller discussion of this subject in the publication, 
System Monitor.) 

The steps necessary to use common in a subprogram 
are discussed under "dav — Define Area in common," 
in the subsection "Declarative Operation Codes." 



Processing Options 

There are four processing options which can be exer- 
cised by the user: 

1. He can suppress the printing of the assembly list- 
ing ( on the Standard Print Unit ) . 

2. He can suppress the punching of the object deck 
( on the Standard Punch Unit ) . 

3. If there are no macro statements in the source 
deck, he can speed up the assembly process by indicat- 
ing this fact. 

4. He can suppress the diagnostic generation of an 
"M" flag for uses of index registers 14 and 15 when 
there is no true multiple definition. ( See note 1, under 
"Indexing with Address Adjustment." ) 

These options are indicated by means of additional 
parameters in the exeq card that calls the Autocoder 
processor. 

The four parameters are: 
noprt — Suppress printing 
nopch — Suppress punching 
nomac — No macros present 
noflg — Suppress "M" flag 
Any or all of these parameters may be used in the 
exeq card. They can appear in any order immediately 
following the exeq parameters required by the System 
Monitor. (See the publication, System Monitor, for 
details concerning the exeq card. ) 



Specification of parameters in the exeq card is con- 
cluded by the first blank encountered in the operand 
field. The following examples illustrate the format: 



OPERATION 



LABEL CODE 

MON$$ EXEQ 

MON$$ EXEQ 

MON$$ EXEQ 



OPERAND 

AUTOCODER, SOF, SIU, NOPRT 

AUTOCODER, , , NOMAC, NOPCH, 

NOFLG 

AUTOCODER, , , NOFLG, NOPRT, 

NOMAC, NOPCH 



Autocoder Multiple Compilation 

Autocoder can compile any number of programs with a 
single mon$$ exeq autocoder card. The output is the 
same as if it were produced by several separate com- 
pilations. 

Input for a multiple compilation consists of the 
mon$$ exeq autocoder card followed by the source 
decks to be compiled. No control cards are necessary 
between the end statement of one program and the first 
card of the next program if the programmer wants the 
subsequent compilation to receive standard treatment; 
that is, printing, punching, and normal macro and flag 
processing. 

A different set of processing options ( noprt, nopch, 
nomac or noflg) can be specified for an ensuing pro- 
gram in a multiple compilation by placing an Option 
card after the preceding end statement. This card has 
the same requirements and options as the mon$$ exeq 
autocoder card except that the label and operation 
fields, card columns 6-20, must contain blanks ( instead 
of mon$$ exeq ) . The processing options specified in this 
Option card will be applied until the next Autocoder 
end card is read by the processor. 

Autocoder multiple compilation has two potential 
advantages: 

1. It enables the programmer to process a series of 
source decks from the Alternate Input Unit as well as 
the Standard Input Unit. 

2. It bypasses the monitor processing which normally 
is necessary between compilations. 



Terminating the Object Program 

The object progam must terminate execution by means 
of one of the following instructions: 

b /eop/ Normal End of Program 
b /uep/ Unusual End of Program 

Both forms of termination are shown in Figure 2. Full 
details can be found in the publication, System Monitor. 
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SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOO OPERAND 



PAGE 1 
CT AODRS INSTRUCTION 



SAMPL 
CARD FLAG 



1 AA020 

2 AA030 

3 S A040 

4 AA050 

5 AA060 

6 AA070 

7 AA080 

8 AA090 

9 AA100 

AAUO 

1 AA120 

2 AA130 

3 AA135 
AA140 

15 G AAUO 

16 G 01510 

17 G 01520 

18 G 01530 

19 G 01580 

20 AA145 
AA148 
AA150 
AA160 
AA170 
AA175 
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TITLE SEQUENCE 

• THIS SUBPROGRAM CHECKS THE SEQUENCE OF THE PGLN/ FIELD 

• IF THE PGLN/ FIELD IS 99999, THE PROGRAM IS TERMINATED NORMALLY 

• A NON-ASCENDING SEQUENCE RESULTS IN AN UNUSUAL END OF PROGRAM. 
SEQROUTINE SBR EXITSEQRT65 

C PGLN/.S999993 IS THIS THE LAST ENTRY 

BE ENDOFJOB YES 

NOPWM 

B CHECKSEQ 

SH »-!2 



SET FIRST TIME NOP SWITCH TO BRANCH 



HLCMB PGLN/,PGLNH0LD#5 



ENDOFJOB IOCTL TYPE, MESSAGE 

ENDOFJOB EQU » 

BZN »-U./CTB/ 

BXPA /CNC/ 

DCM MESSAGE 

BZN •-11,/CTB/ 

B /EOP/ 



EXIT - RETURN TO MAIN PROGRAM 



NOTIFY OPERATOR OF END OF JOB 



NORMAL END OF PROGRAM 



C PGLNHOLD, PGLN/ 

BH EXITSEQRT-12 BRANCH IF PGLN/ IS IN SEQUENCE 

B /UEP/ UNUSUAL END OF PROGRAM 



7 00000 G 00056 B 002 

11 00007 C PGLN/ 00153 002 
7 00018 J 00058 S 002 
1 00025 N 002 
7 00026 J 00101 002 

6 00033 , 00026 002 

12 00039 D PGLN/ 00158 P 003 

7 00051 J 00000 003 



00058 

12 00058 V 00058 /CTB/ 2 003 

7 00070 Y /CNC/ X 003 

5 00081 00126 003 

12 00082 V 00082 /CTB/ 2 004 

7 00094 J /EOP/ 004 

11 00101 C PGLN/ 00158 004 

7 00112 J 00039 U 004 

7 00119 J /UEP/ 004 



64015 
SEQNO PGLIN LABEL 



SAMPLE SUBPROGRAM USING THE 1410/7010 AUTOCODER 
OPCOD OPERAND 



26 AA180 SEQR/ DEFIN SEQROUTINE SEQR/ LINKAGE SYMBOL FOR SUBPROGRAM 

27 AA185 MESSAGE OCW aEND OF JOBS.G CONSOL PRINTER NOTICE 

28 AA190 HALT 12345 EXAMPLE OF AN ERRONEOUS STATEMENT 

29 AA200 END 

30 3999993 

31 PGLNHOLO #0005 

NUMBER OF FLAGGED STATEMENTS 1 
28 

1410/7010 AUTOCODER. ..SYSTEM /MID/ 0001 
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► Figure 2. A Page from an Assembly Listing 



Assembly Listing 

Each page of the assembly listing contains a page 
heading line and a column heading line. 

The page heading line contains the following infor- 
mation, from left to right: 

1. The date contained at location /dat/ (the system 
symbol for the five-position date field in the Resident 
Monitor ) 

2. Information supplied via headr card 



3. Page number in the listing 

4. The identification supplied by headr or reseq 
cards 

The column heading line is illustrated in Figure 2, 
which shows the assembly listing of a subprogram 
assembled by the 1410/7010 Autocoder processor. 
The subprogram contains a deliberate error contrived 
to exhibit Autocoder's diagnostic flagging system. Fig- 
ure 2 illustrates the following items, going from left 
to right in the column heading line: 
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Figure 78. ibm 1410/7010 Library Coding Form 
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Figure 79. Macro Operations 



Figure 80. Model Statement for a Complete Instruction 



that a corresponding parameter from the macro- 
instruction operand field must be inserted in its 
place. This code is a n followed by a number 
from 001 to 199, that indicates the position of 
the parameter in the macro-instruction. The 
macro-instruction in the source program will 
give the parameter entries to be inserted in the 
object routine. The model statement is illus- 
trated in Figure 81. 
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Figure 81. Model Statement for an Incomplete Instruction with 
Required Parameters 

c. If the entry is incomplete, the programmer writes 
a □ followed by a number from 001 to 199 with 
ab bits over the units position (parameter 001 
is nOOA, parameter 2 is nOOB, etc. ) . This indi- 
cates that the entry is to be included in the 
object routine only if the parameter is specified 
by the macro-instruction. For example, if pa- 
rameter 003 does not appear in the macro- 
instruction, the instruction shown in Figure 82 
will be deleted from the object routine. 
Note: If parentheses are used, the programmer can- 
not use zoned switches in a math or bool statement. 



Page 
and 
Line 


L 


Label 


Operation 


1 


12 3 4 5 


6 


7 8 9 101112131415161718192021 


22 2324 2526 


272829303132 33 34 3536 37383940414243 44 












































B 










a 








G 




























1 





























































Figure 82. Model Statement for an Incomplete Instruction with 
Conditional Parameters 

Labeling: If the model statement represents an in- 
struction entry point for a branch instruction elsewhere 
in the program, it should have a label. 

If additional external labels are required and speci- 
fied as parameters in the macro-instruction they can 
be inserted in the label field of the symbolic program 
entry by using the nOOl-199 code. 

The label of the macro-instruction causes the genera- 
tion of an equate statement in the assembled object 
routine. The label is equated to an *, as shown in 
Figure 83. 
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Another example is shown in Figure 84. 

Symbolic Addressing within the Library Routine: 
To allow a symbolic reference to other instructions in a 
library routine a nfollowed by a number from 001 to 
199 with a B bit over the units position ( nOOJ = sym- 
bolic address 1, nOOK = symbolic address 2, etc. ) can 
be used. For example, the processor generates the sym- 
bolic address if the code nOOJ is used as a label for one 
entry and as an operand of at least one other entry in 
the same library routine. 

Internal labels within flexible routines are generated 
in the form nnnnmmm, where nnn is the code (00J- 
09R), and mmm is the number of the macro within 
the source program. This is done to avoid duplicate 
address assignments for labels. 

Example: Use the generated symbolic address of 
nOOJ as an operand for entry 3 and as the label for 
entry 6. updat is the 23d macro encountered in the 
source program (Figure 85). 

Address Adjustment and Indexing: The parameters 
in a macro-instruction and the operands in partially 
complete instructions in a library routine can have 
address adjustment and indexing. 

If address adjustment is used in both the parameter 
and the instruction, the assembled instruction will be 
adjusted to the algebraic sum of the two. For example, 
if the address adjustment on one is +7 and the other 
is —4, the assembled instruction will have address 
adjustment equal to +3. 

Model statement operands can be indexed. This in- 
dexing takes precedence over any indexing of a param- 
eter supplied by a macro-instruction. The model state- 
ment index is used. 

Literals: Operands of instructions in library routines 
may use literals as required. However, these literals 
may not contain the @ symbol within an alphameric 
literal. 

Note: Area defining literals and area defining con- 
stants cannot be used in a macro statement. 
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Figure 84. Additional External Labels 
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Assembled Symbolic Program Entry 
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Figure 85. Internal Labels 

Note 1: A model statement in the library routine for 
a macro-instruction may not be another macro-instruc- 
tion. 

Note 2: end statements cannot be used in library 
routines. 

Note 3: A comments card can be included in the 
model statements. It must be written with an asterisk 
in column 7. 

The Processor enters model statements in the library 
tape immediately following the header statement dur- 
ing System Generation. 

Result: Any library routine can be extracted by writ- 
ing the associated macro-instruction in the source 
program. 

Figure 86 is a summary of the codes that can be 
used in the model statements of library routines. 
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Figure 86. Model Statement Codes 

General Description: A macro-instruction is the entry 
in the source program that causes a series of instruc- 
tions to be inserted in a program. 

The Programmer: 

1. Writes the name of the library routine in the 
operation field. 
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2. Writes the label that is to reference the first as- 
sembled model statement. A label equ * is generated 
to do this. 

3. Writes the parameters that are required for the 
particular object routine desired. These parameters, 
used by the model statements, are written as follows: 

a. Parameters must be written in the sequence in 
which they are to be used by the codes in the 
model statements. For example, if cost is 
parameter 001, it must be written first so that it 
will be substituted wherever a nOOl or nOOA 
appears as a label, operation code, or operand 
of a model statement. 

b. As many parameters may be used as can be 
contained in the operand fields of five or fewer 
coding sheet lines. If more than one line is 
needed for a macro-instruction, the label and 
operation fields of the additional lines must be 
left blank. Parameters must be separated by a 
comma. They cannot contain blanks or commas 
unless they appear between @ symbols. The 
@ symbol itself cannot appear between @ sym- 
bols. Also, the @ symbol can be used only in 
pairs as a literal identifier. It cannot be used 
in any other way; e.g., a single @ symbol could 
not be used to represent the d modifier of a 
macro-instruction. If parameters for a single 
macro-instruction require more than one coding 
sheet line, the last parameter in each line must 
be followed immediately by a comma. The 
last parameter in a macro-instruction should 
not be followed by a comma. 

c. Parameters that are not required for the par- 
ticular object routine desired can be omitted 
from the operand field of the macro-instruction. 
However, if a parameter is omitted, the comma 
that would have followed the parameter must 
be included, unless the omitted parameter is 
behind the last parameter which is included in 
the macro-instruction. These commas are nec- 
essary to count parameters up to the last in- 
cluded parameter. All parameters between the 
last included parameter and parameter 199 are 
assumed by the processor to be absent. 

Figures 87, 88, 89 and 90 show how parameters can 
be omitted. The hypothetical macro-instruction called 
exact is used, exact can have as many as nine 
parameters. 

The Processor extracts the library routine and selects 
the model statements required for the object routine 
as specified by the parameters in the macro-instruc- 
tions, and by substitution and switches set by bool or 
comp in the model statements. 
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Figure 87. Parameter for exact. 006-199 Missing 
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Figure 88. Parameters 004 and 006-199 Missing 
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Figure 89. Parameters 001, 004-006, 008 and 010-199 Missing 
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Figure 90. Parameters 001 and 003-199 Missing 

Result: The resulting program entries are merged 
with the source program entries behind the macro- 
instruction. 

Pseudo-Macro Instructions 

These statements never appear in a user's source pro- 
gram or in the output listing of an assembled Auto- 
coder program. However, they are used in library 
routines to signal the processor that certain conditions 
exist which can affect the assembly of an object routine. 
For example, the presence of a pseudo-macro- 
instruction in a library routine can cause a group of 
model statements to be deleted. Thus, pseudo-macros 
provide the writer of library routines with a coding 
flexibility which exceeds the limitations of the substitu- 
tion and condition codes described previously. 

Pseudo-macro-instructions may be written anywhere 
in a library routine. The five pseudo-macros incorpo- 
rated in the Autocoder processor are math, bool, 
comp, note, and mend. 

Permanent and Temporary Switches 

The math, bool, and comp pseudo-macros use internal 
indicators (switches) to signal the processor of exist- 
ing status conditions. 

There are 099 permanent and 199 temporary 
switches available for recording status conditions. Each 
switch occupies one core-storage position during the 



macro generator phase of Autocoder. If a storage posi- 
tion contains the character A (ab 1 bits), the switch is 
on; if it contains a ? (cab 82 bits), the switch is off. 
At the beginning of assembly all switches are off. 

Permanent Switches: Permanent switches retain 
status conditions during the entire macro generator 
phase unless changed by a pseudo-macro. They are 
addressed by using a # symbol followed by the three- 
digit number of the switch to be set or tested. For 
example, #001 addresses permanent switch 001; #002 
addresses switch 002; and #099 addresses switch 099. 

Temporary Switches: When the processor encounters 
a macro-instruction, the temporary switches are set to 
the condition ( presence or absence ) of the parameters 
in the operand of the macro field. If the parameter is 
present, the corresponding switch is set on. If the 
parameter is missing, the switch is set off. For ex- 
ample, if parameter 001 is present, temporary switch 
001 is turned on. If parameter 002 is missing from the 
macro-instruction, temporary switch 002 is off. Tem- 
porary switches retain status throughout the processing 
of a macro-instruction unless changed by a pseudo- 
macro. After the macro-instruction has been completely 
processed, all temporary switches are set off. Tempo- 
rary switches are addressed by using a □ symbol fol- 
lowed by the three-digit number of fhe switch to be set 
or tested. For example, n001 addresses temporary 
switch 001; n002 addresses switch 002; and nl99 ad- 
dresses switch 199. 

If a macro with a maximum of nine parameters is 
encountered, the processor sets the first nine temporary 
switches to indicate the presence or absence of these 
nine parameters. Temporary switches 010-199, which 
are off, can be used by the pseudo-macros to com- 
municate conditions to the processor while it is working 
on this particular macro-instruction. This use of tempo- 
rary switches is recommended because it reserves the 
permanent switches for communicating information 
from one macro to another. 

MATH — For Solving Algebraic Expressions 

A math pseudo-macro contains as operands: sum 
boxes, arithmetic expressions, and sign switches. 

Sum Boxes: A sum box is a group of five core- 
storage positions used to store the result of an arith- 
metic expression. Autocoder makes available 20 such 
sum boxes. A sum box is addressed by using a # 
symbol followed by the three-digit number (ending 
in zero or five) of the sum box to be referenced. For 
example, the address of the first sum box is #005; the 
address of the second sum box is #010; and the address 
of the twentieth sum box is #000. 

At the beginning of the macro phase, a sum box 
contains 00000. Any number may be placed in a sum 
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is off, the statement is false. Therefore, set temporary 
switch 015 off and skip to statement labeled L. 
The example shown in Figure 97 states: 

1. If both temporary switches 001 and 002 or both 
temporary switches 003 and 004 are on, the state- 
ment is true. Therefore, set temporary switch 015 
on. 

2. However, if either temporary switch 001 or 002 
and either temporary switch 003 or 004 is off, 
the statement is false. Therefore, set temporary 
switch 015 off and skip to the model statement 
whose label is L, 
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Figure 97. bool Pseudo-Macro 



Figure 99. False Conditions 



Figure 98 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
true. 

Figure 99 is a table showing all conditions that will 
cause the bool statement shown in Figure 97 to be 
false. 



COMP — To Compare Two Fields 

General Description: The comp pseudo-macro com- 
pares an A-field to a B-field (maximum of 15 charac- 
ters), and sets permanent or temporary switches to 
indicate the result of the comparison. 

The Programmer: 

1. Writes the name of the pseudo-macro (comp) 
in the operation field. 
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2. Writes the operand field in the format shown in 
Figure 100. The first and second entries are the A- and 
B-fields. The A- and B-fields may be any of the 
parameters 001-199, sum boxes #005-#000, or literals. 
They cannot be switches. 

Note 1: For the comp pseudo-macro, alphameric 
literals are not enclosed by @ symbols. Entries 3, 4, 
and 5 are high, equal, and low switches. 

Note 2: The codes for the two fields to be compared 
must be present in all comp pseudo-macro-instructions. 
Codes for the switches may be omitted if they are not 
needed to store the result of the compare operation. 
However, if a 'switch is omitted, the comma that 
would have followed it must be included in the 
operand field. 

Note 3: B-field controls compare. (High-order posi- 
tion of B-field ends compare. ) 
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Figure 100. Format for comp Pseudo-Macro 



Figure 98. True Conditions 



The Processor: 

1. Compares the A-field to the B-field. 

2. Sets one status switch on and two switches off 
to reflect the result of the comparison. 

a. The first switch is set on, if the value of the 
B-field is greater than that of the A-field. 
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b. The second switch is set on, if the B-field is 
equal to the A-field. 

c. The third switch is set on, if the value of the 
B-field is less than that of the A-field. 

Examples: Figure 101 shows a comp pseudo-macro 
which states: 

1. Compare parameter 002 of the macro statement 

tO WORK ARE A. 

2. If parameter 002 is equal to workarea, turn on 
temporary switch 25. 

3. If workarea is less than parameter 002, turn on 
temporary switch 26. 



9 1011 12 131415 1617 181920 21 22 23 24 2526 



COMP 



Operand and Comml 



2728 293031 32 33 34 3536 37 38 3940 41 42 43 44 45 4647 48 49 50 51 52 53 541 



H002, WORKAREA, ,»025,n026 



Figure 101. comp Pseudo-Macro 



The message is printed in line on the output device 
(tape or on-line printer). In addition, an "N" will be 
automatically inserted in the flag field of the assembly 
listing. 

The Programmer: 

1. Writes the name of the pseudo-macro (note) in 
the operation field. 

2. Writes the message in the operand field. 

Note: Two successive blanks terminate the operand 
of a note statement. 

The Processor: Prints the message on the Standard 
Print Unit (tape or on-line printer). 

Examples: Figure 104 shows how the note pseudo- 
macro can be used in combination with the bool 
pseudo-macro. The bool pseudo-macro tests to ensure 
that parameters 001 and 002 are present in the macro- 
instruction. If either parameter is missing, the proc- 
essor skips to the note pseudo-macro and prints: 



Figure 102 shows a comp pseudo-macro which 
states: 

1. Compare the contents of sum box 005 to param- 
eter 003 of the macro statement. 

2. If the result is high, set temporary switch 024 on. 

3. If the result is equal, set temporary switch 025 

ON. 

4. If the result is low, set temporary switch 026 on. 



parameter absent from macro. 




Figure 102. Comparing a Parameter to the Contents of a 
Sum Box 



Note: Standard 1410/7010 collating sequence deter- 
mines high, equal, or low conditions. Comparisons 
are controlled by the B-field. Thus, the statement 
shown in Figure 103 will cause temporary switch 025 
to be set on if the low-order position of parameter 
002 is a 3. 

NOTE — To Produce a Message 

General Description: The note pseudo-macro is 
used to write messages concerning conditions that can 
arise during the processing of a macro-instruction. 
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Figure 103. Checking for a Single Character 
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Figure 104. note Pseudo-Macro 

MEND - End of Routine 

General Description: This pseudo-macro signals the 
end of generation for a macro-instruction. It may ap- 
pear anywhere in a library routine. 

The Programmer: 

1. Writes the name of the pseudo-macro (mend) in 
the operation field. 

2. Leaves the operand field blank. 

The Processor: Stops processing the macro-instruc- 
tion when it encounters a mend statement. Figure 105 
shows a mend pseudo-macro. 

Note: A bool pseudo-macro can be used to skip 
over a mend pseudo-macro which appears within the 
library routine if conditions indicate that more model 
statements must be processed. 
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Figure 105. mend Pseudo-Macro 
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